API-referentie

Elk endpoint, elke parameter, elk responseveld. Basis-URL: https://cleverutils.com/api/v1

Universele converter

POST/api/v1/convert

Converteert een enkel bestand naar een doelformaat. Gebruikt door meer dan 143 formaatparen (beeld, audio, video, document, archief, 3D, lettertype).

Request (multipart/form-data)

VeldTypeOpmerkingen
file VERPLICHTbestandHet bronbestand. Maximaal 200 MB.
to_format VERPLICHTstringExtensie van het doelformaat, bijv. png, mp3, pdf, webp. 2–5 alfanumerieke tekens.
img_quality optioneelintBeeldkwaliteit 0–100. Standaard 80. Wordt gebruikt voor JPG-, WebP-, PDF-compressie.
img_resize_w, img_resize_h optioneelintSchalen naar exacte afmetingen (16–7680 px). Gebruik een of beide.
img_rotate optioneelstringRoteren: 90, 180, 270, flip-h, flip-v.
img_crop_x, img_crop_y, img_crop_w, img_crop_h optioneelintBijsnijdgebied in pixels.
mp3_mode, mp3_quality, mp3_bitrate optioneeldiverseMP3-encoderopties. Zie audioreferentie.
wav_rate, wav_depth, wav_channels optioneelintWAV-uitvoeropties.
ocr_lang optioneelstringTesseract-taal voor PDF/beeld-OCR. Standaard eng.

Response (succes, 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"
} }

Batchverwerking

POST/api/v1/batch

Converteert maximaal 20 bestanden in één request. Elk bestand telt individueel mee voor uw dagquotum.

VeldTypeOpmerkingen
files[] VERPLICHTbestand[]Maximaal 20 bestanden in één multipart-request.
to_format VERPLICHTstringDoelformaat toegepast op alle bestanden.

Response-structuur

Geeft een batch_id terug plus een array van jobs per bestand. Gebruik GET /api/v1/batches/{batch_id} om later de geaggregeerde status op te vragen.

Job-levenscyclus

GET/api/v1/jobs/{job_id}

Vraagt de status van een conversie-job op. job_id is 32 hexadecimale tekens die door /api/v1/convert worden geretourneerd.

Response-toestanden

  • data.status: "processing" — conversie bezig, optioneel progress 0–99
  • data.status: "done" — conversie voltooid, output-blok ingevuld
  • HTTP 404 met error.code: JOB_NOT_FOUND — ongeldige ID of verlopen
  • HTTP 500 met error.code: CONVERSION_FAILED — conversie gecrasht
GET/api/v1/jobs/{job_id}/output

Stuurt het geconverteerde bestand als binaire bijlage. Geeft Content-Type terug dat overeenkomt met het uitvoer-MIME en Content-Disposition: attachment; filename=.... Bestanden verlopen 2 uur na conversie.

GET/api/v1/batches/{batch_id}

Geaggregeerde status van alle jobs in een batch. Formaat van batch_id: bat_ gevolgd door 16 hexadecimale tekens. Bevat overall_status (done / processing / failed) plus de array per job.

AI-tools

POST/api/v1/tools/{slug}

Gespecialiseerde tools die niet in een eenvoudige formaatconversie passen. Elke tool heeft zijn eigen parameterset.

SlugBeschrijvingDaglimiet
upscale-imageAI 2x/3x/4x upscale (Real-ESRGAN). Optioneel: scale, model.50
enhance-photoAutomatische fotoverbetering (momenteel alias voor colorize).50
vocal-removerZang scheiden van instrumentaal (Demucs).50
speech-to-textAudio/video transcriberen. Opties: format (txt/srt/vtt), quality, language.100
remove-backgroundBeeldachtergrond verwijderen (rembg).100
colorize-photoZwart-witfoto's inkleuren (siggraph17).50
restore-old-photoOude foto's herstellen en inkleuren.50
noise-reductionAudioruisonderdrukking (DeepFilterNet3).50
change-backgroundBeeldachtergrond vervangen.100
remove-objectObject verwijderen via inpainting (LaMa).50
passport-photoPaspoortfoto genereren.100
image-to-textOCR (Tesseract). Geeft text terug in JSON, geen download_url.100

Beeldbewerkingstools

POST/api/v1/tools/{slug}
SlugBeschrijving
resize-imageGrootte aanpassen. Geef img_resize_w en/of img_resize_h mee.
compress-image, compress-jpg, compress-png, compress-webp, compress-gifComprimeren met img_quality.
crop-imageGebied bijsnijden met img_crop_x/y/w/h.
rotate-imageRoteren via img_rotate.
grayscale-imageConverteren naar grijswaarden.
blur-imageGaussiaanse vervaging toepassen.
watermark-imageTekstwatermerk toevoegen.
og-image-resizerSchalen naar standaard OG-afmetingen (1200x630).

Audio- & videobewerkingstools

POST/api/v1/tools/{slug}
SlugBeschrijving
audio-cutterAudio knippen. Geef start_time, end_time mee.
trim-videoVideo inkorten tot tijdbereik.
compress-videoComprimeren met doelbitrate of kwaliteitspreset.
extract-audio-from-videoAudiospoor extraheren als MP3.
remove-audio-from-videoAudio uit video verwijderen.
merge-videosMeerdere videobestanden samenvoegen. Stuur files[].
reverse-videoVideo achteruit afspelen.
gif-makerAnimated GIF maken uit frames of video.

PDF-tools

POST/api/v1/tools/{slug}
SlugBeschrijving
compress-pdfComprimeren met kwaliteit 0–100 (gemapt op Ghostscript /screen, /ebook, /printer, /prepress).
merge-pdfMeerdere PDF's samenvoegen. Stuur files[].
split-pdfPDF opsplitsen in afzonderlijke pagina's.
pdf-page-removerSpecifieke pagina's verwijderen. Geef pages mee als kommagescheiden lijst.
protect-pdfWachtwoord toevoegen. Geef password mee.
unlock-pdfWachtwoord verwijderen. Geef password mee.
webpage-to-pdfURL omzetten naar PDF. Geef url mee in plaats van file.

Health en limieten

GET/api/v1/health

Liveness-probe. Geeft servicestatus en gedetecteerde versies van binaries (ImageMagick, FFmpeg, Ghostscript, LibreOffice, Tesseract) terug. Telt NIET mee voor rate limits.

GET/api/v1/limits

Alleen-lezen inspectie van uw huidige rate-limit-gebruik. Geeft dag- en uurtellers, resterende quota en banstatus terug. Telt NIET mee voor rate limits.

Zie ook

Functie aanvragen

0 / 2000