API-Referenz

Jeder Endpoint, jeder Parameter, jedes Antwortfeld. Basis-URL: https://cleverutils.com/api/v1

Universeller Konverter

POST/api/v1/convert

Konvertiert eine einzelne Datei in ein Zielformat. Genutzt von über 143 Formatpaaren (Bild, Audio, Video, Dokument, Archiv, 3D, Schriftart).

Request (multipart/form-data)

FeldTypHinweise
file ERFORDERLICHDateiDie Quelldatei. Bis zu 200 MB.
to_format ERFORDERLICHStringZielformat-Erweiterung, z. B. png, mp3, pdf, webp. 2–5 alphanumerische Zeichen.
img_quality optionalintBildqualität 0–100. Standard 80. Verwendet für JPG-, WebP-, PDF-Komprimierung.
img_resize_w, img_resize_h optionalintAuf exakte Abmessungen skalieren (16–7680 px). Eines oder beides verwenden.
img_rotate optionalStringRotation: 90, 180, 270, flip-h, flip-v.
img_crop_x, img_crop_y, img_crop_w, img_crop_h optionalintZuschnittbereich in Pixeln.
mp3_mode, mp3_quality, mp3_bitrate optionalverschiedenOptionen des MP3-Encoders. Siehe Audio-Referenz.
wav_rate, wav_depth, wav_channels optionalintWAV-Ausgabeoptionen.
ocr_lang optionalStringTesseract-Sprache für PDF/Bild-OCR. Standard eng.

Response (Erfolg, 200)

JSON
{ "data": {
    "job_id": "5f8c1a2e9d4b7c0e3f6a8b2d1e4c5f78",
    "status": "done",
    "output": { "filename": "photo_cleverutils.com.jpg", "size_bytes": 184523, "size_human": "180 KB", "url": "https://cleverutils.com/api/v1/jobs/5f8c.../output" },
    "links": { "self": "...", "output": "..." },
    "expires_at": "2026-04-10T14:32:11Z"
} }

Batch-Verarbeitung

POST/api/v1/batch

Konvertiert bis zu 20 Dateien in einem einzigen Request. Jede Datei zählt einzeln gegen Ihr Tageskontingent.

FeldTypHinweise
files[] ERFORDERLICHDatei[]Bis zu 20 Dateien in einem einzigen multipart-Request.
to_format ERFORDERLICHStringZielformat wird auf alle Dateien angewendet.

Response-Struktur

Gibt eine batch_id plus ein Array von jobs pro Datei zurück. Verwenden Sie GET /api/v1/batches/{batch_id}, um den aggregierten Status später abzufragen.

Job-Lebenszyklus

GET/api/v1/jobs/{job_id}

Fragt den Status eines Konvertierungs-Jobs ab. job_id besteht aus 32 Hex-Zeichen, die von /api/v1/convert zurückgegeben werden.

Response-Zustände

  • data.status: "processing" — Konvertierung läuft, optional progress 0–99
  • data.status: "done" — Konvertierung abgeschlossen, Block output gefüllt
  • HTTP 404 mit error.code: JOB_NOT_FOUND — ungültige ID oder abgelaufen
  • HTTP 500 mit error.code: CONVERSION_FAILED — Konvertierung abgestürzt
GET/api/v1/jobs/{job_id}/output

Streamt die konvertierte Datei als binären Anhang. Gibt Content-Type passend zum Ausgabe-MIME und Content-Disposition: attachment; filename=... zurück. Dateien verfallen 2 Stunden nach der Konvertierung.

GET/api/v1/batches/{batch_id}

Aggregierter Status aller Jobs in einem Batch. Format von batch_id: bat_ gefolgt von 16 Hex-Zeichen. Enthält overall_status (done / processing / failed) plus das Array pro Job.

KI-Werkzeuge

POST/api/v1/tools/{slug}

Spezialisierte Werkzeuge, die nicht in eine einfache Formatkonvertierung passen. Jedes Werkzeug hat seine eigenen Parameter.

SlugBeschreibungTageslimit
upscale-imageKI 2x/3x/4x Hochskalierung (Real-ESRGAN). Optional: scale, model.50
enhance-photoAutomatische Fotoverbesserung (derzeit auf colorize aliasiert).50
vocal-removerGesang vom Instrumental trennen (Demucs).50
speech-to-textAudio/Video transkribieren. Optionen: format (txt/srt/vtt), quality, language.100
remove-backgroundBildhintergrund entfernen (rembg).100
colorize-photoSchwarzweißfotos kolorieren (siggraph17).50
restore-old-photoAlte Fotos restaurieren und kolorieren.50
noise-reductionAudio-Rauschunterdrückung (DeepFilterNet3).50
change-backgroundBildhintergrund ersetzen.100
remove-objectObjekt per Inpainting entfernen (LaMa).50
passport-photoPassfoto generieren.100
image-to-textOCR (Tesseract). Gibt text in JSON zurück, keine download_url.100

Bildbearbeitungswerkzeuge

POST/api/v1/tools/{slug}
SlugBeschreibung
resize-imageGröße ändern. Übergeben Sie img_resize_w und/oder img_resize_h.
compress-image, compress-jpg, compress-png, compress-webp, compress-gifMit img_quality komprimieren.
crop-imageBereich zuschneiden mit img_crop_x/y/w/h.
rotate-imageRotation über img_rotate.
grayscale-imageIn Graustufen umwandeln.
blur-imageGaußschen Weichzeichner anwenden.
watermark-imageText-Wasserzeichen hinzufügen.
og-image-resizerAuf Standard-OG-Abmessungen (1200x630) skalieren.

Audio- & Videobearbeitungswerkzeuge

POST/api/v1/tools/{slug}
SlugBeschreibung
audio-cutterAudio schneiden. Übergeben Sie start_time, end_time.
trim-videoVideo auf Zeitbereich kürzen.
compress-videoKomprimieren mit Zielbitrate oder Qualitätspreset.
extract-audio-from-videoAudiospur als MP3 extrahieren.
remove-audio-from-videoAudio aus Video entfernen.
merge-videosMehrere Videodateien zusammenführen. Senden Sie files[].
reverse-videoVideo rückwärts abspielen.
gif-makerAnimiertes GIF aus Frames oder Video erstellen.

PDF-Werkzeuge

POST/api/v1/tools/{slug}
SlugBeschreibung
compress-pdfKomprimieren mit Qualität 0–100 (gemappt auf Ghostscript /screen, /ebook, /printer, /prepress).
merge-pdfMehrere PDFs zusammenführen. Senden Sie files[].
split-pdfPDF in einzelne Seiten aufteilen.
pdf-page-removerBestimmte Seiten entfernen. Übergeben Sie pages als kommagetrennte Liste.
protect-pdfPasswort hinzufügen. Übergeben Sie password.
unlock-pdfPasswort entfernen. Übergeben Sie password.
webpage-to-pdfURL in PDF umwandeln. Übergeben Sie url anstelle von file.

Health und Limits

GET/api/v1/health

Liveness-Probe. Gibt Dienststatus und erkannte Versionen von Binärdateien (ImageMagick, FFmpeg, Ghostscript, LibreOffice, Tesseract) zurück. Zählt NICHT gegen Rate-Limits.

GET/api/v1/limits

Schreibgeschützte Einsicht in Ihre aktuelle Rate-Limit-Nutzung. Gibt Tages- und Stundenzähler, verbleibende Kontingente und Bann-Status zurück. Zählt NICHT gegen Rate-Limits.

Siehe auch

Funktion vorschlagen

0 / 2000