Riferimento dell'API

Ogni endpoint, ogni parametro, ogni campo di risposta. URL di base: https://cleverutils.com/api/v1

Convertitore universale

POST/api/v1/convert

Converte un singolo file in un formato di destinazione. Utilizzato da oltre 143 coppie di formati (immagine, audio, video, documento, archivio, 3D, carattere).

Request (multipart/form-data)

CampoTipoNote
file OBBLIGATORIOfileIl file sorgente. Fino a 200 MB.
to_format OBBLIGATORIOstringaEstensione del formato di destinazione, ad es. png, mp3, pdf, webp. 2–5 caratteri alfanumerici.
img_quality facoltativointQualità dell'immagine 0–100. Predefinito 80. Usato per la compressione JPG, WebP, PDF.
img_resize_w, img_resize_h facoltativointRidimensiona a dimensioni esatte (16–7680 px). Usa una o entrambe.
img_rotate facoltativostringaRuota: 90, 180, 270, flip-h, flip-v.
img_crop_x, img_crop_y, img_crop_w, img_crop_h facoltativointArea di ritaglio in pixel.
mp3_mode, mp3_quality, mp3_bitrate facoltativovariOpzioni del codificatore MP3. Vedi il riferimento audio.
wav_rate, wav_depth, wav_channels facoltativointOpzioni di output WAV.
ocr_lang facoltativostringaLingua Tesseract per OCR PDF/immagine. Predefinito eng.

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

Elaborazione in batch

POST/api/v1/batch

Converte fino a 20 file in una singola request. Ogni file conta individualmente sulla tua quota giornaliera.

CampoTipoNote
files[] OBBLIGATORIOfile[]Fino a 20 file in una singola request multipart.
to_format OBBLIGATORIOstringaFormato di destinazione applicato a tutti i file.

Struttura della response

Restituisce un batch_id più un array di jobs per file. Usa GET /api/v1/batches/{batch_id} per consultare lo stato aggregato in seguito.

Ciclo di vita del job

GET/api/v1/jobs/{job_id}

Consulta lo stato di un job di conversione. job_id è di 32 caratteri esadecimali restituiti da /api/v1/convert.

Stati della response

  • data.status: "processing" — conversione in corso, progress facoltativo 0–99
  • data.status: "done" — conversione completata, blocco output popolato
  • HTTP 404 con error.code: JOB_NOT_FOUND — ID errato o scaduto
  • HTTP 500 con error.code: CONVERSION_FAILED — conversione fallita
GET/api/v1/jobs/{job_id}/output

Trasmette il file convertito come allegato binario. Restituisce Content-Type corrispondente al MIME di output e Content-Disposition: attachment; filename=.... I file scadono 2 ore dopo la conversione.

GET/api/v1/batches/{batch_id}

Stato aggregato di tutti i job in un batch. Formato di batch_id: bat_ seguito da 16 caratteri esadecimali. Include overall_status (done / processing / failed) più l'array per job.

Strumenti IA

POST/api/v1/tools/{slug}

Strumenti specializzati che non rientrano in una semplice conversione di formato. Ogni strumento ha il proprio set di parametri.

SlugDescrizioneLimite giornaliero
upscale-imageUpscale IA 2x/3x/4x (Real-ESRGAN). Facoltativi: scale, model.50
enhance-photoMiglioramento automatico della foto (attualmente aliasato a colorize).50
vocal-removerSepara voce e strumentale (Demucs).50
speech-to-textTrascrivere audio/video. Opzioni: format (txt/srt/vtt), quality, language.100
remove-backgroundRimuove lo sfondo dell'immagine (rembg).100
colorize-photoColorizza foto in bianco e nero (siggraph17).50
restore-old-photoRestaura e colorizza foto vecchie.50
noise-reductionRiduzione del rumore audio (DeepFilterNet3).50
change-backgroundSostituisce lo sfondo dell'immagine.100
remove-objectRimuove oggetto tramite inpainting (LaMa).50
passport-photoGenera foto tessera.100
image-to-textOCR (Tesseract). Restituisce text in JSON, nessun download_url.100

Strumenti di modifica immagini

POST/api/v1/tools/{slug}
SlugDescrizione
resize-imageRidimensiona. Passa img_resize_w e/o img_resize_h.
compress-image, compress-jpg, compress-png, compress-webp, compress-gifComprimi con img_quality.
crop-imageRitaglia area con img_crop_x/y/w/h.
rotate-imageRuota tramite img_rotate.
grayscale-imageConverti in scala di grigi.
blur-imageApplica sfocatura gaussiana.
watermark-imageAggiunge filigrana testuale.
og-image-resizerRidimensiona alle dimensioni OG standard (1200x630).

Strumenti di modifica audio & video

POST/api/v1/tools/{slug}
SlugDescrizione
audio-cutterTaglia audio. Passa start_time, end_time.
trim-videoTaglia video su un intervallo temporale.
compress-videoComprime con bitrate di destinazione o preset di qualità.
extract-audio-from-videoEstrae la traccia audio come MP3.
remove-audio-from-videoRimuove l'audio dal video.
merge-videosUnisce più file video. Invia files[].
reverse-videoRiproduce il video al contrario.
gif-makerCrea GIF animata da fotogrammi o video.

Strumenti PDF

POST/api/v1/tools/{slug}
SlugDescrizione
compress-pdfComprime con qualità 0–100 (mappata su Ghostscript /screen, /ebook, /printer, /prepress).
merge-pdfUnisce più PDF. Invia files[].
split-pdfDivide il PDF in pagine singole.
pdf-page-removerRimuove pagine specifiche. Passa pages come elenco separato da virgole.
protect-pdfAggiunge una password. Passa password.
unlock-pdfRimuove la password. Passa password.
webpage-to-pdfConverte URL in PDF. Passa url al posto di file.

Salute e limiti

GET/api/v1/health

Sonda di liveness. Restituisce lo stato del servizio e le versioni rilevate dei binari (ImageMagick, FFmpeg, Ghostscript, LibreOffice, Tesseract). NON conta rispetto ai rate limit.

GET/api/v1/limits

Ispezione in sola lettura del tuo attuale utilizzo del rate-limit. Restituisce contatori giornalieri e orari, quote residue e stato del ban. NON conta rispetto ai rate limit.

Vedi anche

Richiedi una funzione

0 / 2000