Référence de l'API

Chaque endpoint, chaque paramètre, chaque champ de réponse. URL de base : https://cleverutils.com/api/v1

Convertisseur universel

POST/api/v1/convert

Convertit un fichier unique vers un format cible. Utilisé par plus de 143 paires de formats (image, audio, vidéo, document, archive, 3D, police).

Requête (multipart/form-data)

ChampTypeNotes
file REQUISfichierLe fichier source. Jusqu'à 200 Mo.
to_format REQUISchaîneExtension du format cible, par exemple png, mp3, pdf, webp. 2–5 caractères alphanumériques.
img_quality facultatifentierQualité d'image 0–100. Par défaut 80. Utilisée pour la compression JPG, WebP, PDF.
img_resize_w, img_resize_h facultatifentierRedimensionner à des dimensions précises (16–7680 px). Utilisez l'un ou les deux.
img_rotate facultatifchaîneRotation : 90, 180, 270, flip-h, flip-v.
img_crop_x, img_crop_y, img_crop_w, img_crop_h facultatifentierZone de recadrage en pixels.
mp3_mode, mp3_quality, mp3_bitrate facultatifdiversOptions de l'encodeur MP3. Voir la référence audio.
wav_rate, wav_depth, wav_channels facultatifentierOptions de sortie WAV.
ocr_lang facultatifchaîneLangue Tesseract pour l'OCR PDF/image. Par défaut eng.

Réponse (succès, 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"
} }

Traitement par batch

POST/api/v1/batch

Convertit jusqu'à 20 fichiers dans une seule requête. Chaque fichier compte individuellement dans votre quota quotidien.

ChampTypeNotes
files[] REQUISfichier[]Jusqu'à 20 fichiers dans une seule requête multipart.
to_format REQUISchaîneFormat cible appliqué à tous les fichiers.

Structure de la réponse

Retourne un batch_id ainsi qu'un tableau de jobs par fichier. Utilisez GET /api/v1/batches/{batch_id} pour consulter l'état agrégé ensuite.

Cycle de vie des jobs

GET/api/v1/jobs/{job_id}

Consulte l'état d'un job de conversion. job_id fait 32 caractères hexadécimaux retournés par /api/v1/convert.

États de réponse

  • data.status: "processing" — conversion en cours, progress facultatif 0–99
  • data.status: "done" — conversion terminée, bloc output rempli
  • HTTP 404 avec error.code: JOB_NOT_FOUND — ID invalide ou expiré
  • HTTP 500 avec error.code: CONVERSION_FAILED — conversion échouée
GET/api/v1/jobs/{job_id}/output

Diffuse le fichier converti en pièce jointe binaire. Retourne Content-Type correspondant au MIME de sortie et Content-Disposition: attachment; filename=.... Les fichiers expirent 2 heures après la conversion.

GET/api/v1/batches/{batch_id}

État agrégé de tous les jobs d'un batch. Format de batch_id : bat_ suivi de 16 caractères hexadécimaux. Inclut overall_status (done / processing / failed) ainsi que le tableau des jobs.

Outils IA

POST/api/v1/tools/{slug}

Outils spécialisés qui ne relèvent pas d'une simple conversion de format. Chaque outil a son propre jeu de paramètres.

SlugDescriptionLimite quotidienne
upscale-imageAgrandissement IA 2x/3x/4x (Real-ESRGAN). Facultatif : scale, model.50
enhance-photoAmélioration automatique de photo (actuellement aliasé sur colorize).50
vocal-removerSéparation voix/instrumental (Demucs).50
speech-to-textTranscription audio/vidéo. Options : format (txt/srt/vtt), quality, language.100
remove-backgroundSuppression de l'arrière-plan d'une image (rembg).100
colorize-photoColorisation de photos noir et blanc (siggraph17).50
restore-old-photoRestauration et colorisation de vieilles photos.50
noise-reductionRéduction du bruit audio (DeepFilterNet3).50
change-backgroundRemplacement de l'arrière-plan d'une image.100
remove-objectSuppression d'objet par inpainting (LaMa).50
passport-photoGénération de photo d'identité.100
image-to-textOCR (Tesseract). Retourne le text en JSON, pas de download_url.100

Outils d'édition d'images

POST/api/v1/tools/{slug}
SlugDescription
resize-imageRedimensionner. Passez img_resize_w et/ou img_resize_h.
compress-image, compress-jpg, compress-png, compress-webp, compress-gifCompresser avec img_quality.
crop-imageRecadrer avec img_crop_x/y/w/h.
rotate-imageRotation via img_rotate.
grayscale-imageConversion en niveaux de gris.
blur-imageApplique un flou gaussien.
watermark-imageAjoute un filigrane texte.
og-image-resizerRedimensionne aux dimensions OG standard (1200x630).

Outils d'édition audio & vidéo

POST/api/v1/tools/{slug}
SlugDescription
audio-cutterDécoupe l'audio. Passez start_time, end_time.
trim-videoDécoupe la vidéo sur une plage temporelle.
compress-videoCompresse avec un bitrate cible ou un préréglage de qualité.
extract-audio-from-videoExtrait la piste audio en MP3.
remove-audio-from-videoSupprime l'audio de la vidéo.
merge-videosFusionne plusieurs fichiers vidéo. Envoyez files[].
reverse-videoLecture vidéo à l'envers.
gif-makerCrée un GIF animé depuis des images ou une vidéo.

Outils PDF

POST/api/v1/tools/{slug}
SlugDescription
compress-pdfCompresse avec une qualité 0–100 (mappée sur Ghostscript /screen, /ebook, /printer, /prepress).
merge-pdfFusionne plusieurs PDF. Envoyez files[].
split-pdfScinde le PDF en pages individuelles.
pdf-page-removerSupprime des pages spécifiques. Passez pages sous forme de liste séparée par des virgules.
protect-pdfAjoute un mot de passe. Passez password.
unlock-pdfSupprime le mot de passe. Passez password.
webpage-to-pdfConvertit une URL en PDF. Passez url à la place de file.

Santé et limites

GET/api/v1/health

Sonde de vivacité. Retourne l'état du service et les versions détectées des binaires (ImageMagick, FFmpeg, Ghostscript, LibreOffice, Tesseract). NE compte PAS dans les limites de débit.

GET/api/v1/limits

Inspection en lecture seule de votre utilisation actuelle du rate-limit. Retourne les compteurs quotidiens et horaires, les quotas restants et l'état de bannissement. NE compte PAS dans les limites de débit.

Voir aussi

Demander une fonctionnalité

0 / 2000