CleverUtils API
Un'API REST pubblica e gratuita per convertire file. Converti immagini, audio, video, documenti e PDF — più strumenti IA come upscaling, rimozione dello sfondo, isolamento vocale e speech-to-text — con una singola richiesta HTTP. Risposte JSON, limiti di frequenza generosi, supporto batch.
Converti un file con un comando cURL
Nessuna registrazione. Nessuna chiave API. Semplicemente POST un file e ottieni un job indietro.
curl -X POST https://cleverutils.com/api/v1/convert \
-F "[email protected]" \
-F "to_format=jpg"
Risposta (envelope canonico):
{
"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": "https://cleverutils.com/api/v1/jobs/5f8c...",
"output": "https://cleverutils.com/api/v1/jobs/5f8c.../output"
},
"expires_at": "2026-04-10T14:32:11Z"
}
}
Quindi scarica il risultato:
curl -o photo.jpg https://cleverutils.com/api/v1/jobs/5f8c.../output
Vedi la guida rapida completa con Python, Node.js, PHP e Go →
Perché usare l'API?
Gratuita, senza registrazione
Nessuna chiave API, nessun OAuth, nessuna carta di credito. Solo HTTP. Limiti di frequenza generosi basati su IP.
Tutti i formati
55+ formati immagine, 17+ audio, 30+ video, 25+ documento. Più 12 strumenti IA.
Elaborazione batch
Invia fino a 20 file in una singola richiesta. Perfetto per librerie fotografiche, memo vocali e archivi di documenti.
Async-friendly
Ottieni un job_id immediatamente, polling dello stato. Oppure aspetta in modo sincrono per file piccoli.
Caricamenti da 200 MB
Limite più alto del sito web. Progettato per video, foto RAW e documenti grandi.
Stesso motore del sito
ImageMagick, FFmpeg, LibreOffice, Real-ESRGAN, Demucs, Whisper. Collaudato su milioni di file.
Endpoint a colpo d'occhio
Riferimento endpoint completo →
Fatti chiave
- Autenticazione: nessuna richiesta. Anonima, limitazione di frequenza basata su IP.
- Quota predefinita: 1000 richieste al giorno per IP, 150 all'ora, cooldown di 1 secondo tra le richieste.
- Quote strumenti IA: 50–100 al giorno per IP (calcolo intenso).
- Limite dimensione file: 200 MB per file.
- Limite batch: 20 file per richiesta
POST /api/v1/batch. - Conservazione job: i file convertiti vengono eliminati dopo 2 ore — scarica rapidamente.
- CORS:
Access-Control-Allow-Origin: *— funziona da qualsiasi origine browser. - Versioning: basato su URL (
/api/v1/). I cambiamenti di rilievo andranno in v2 con almeno 6 mesi di preavviso. - Stato: vedi /api/status per la salute in tempo reale.
Documentazione
Domande frequenti
L'API di CleverUtils è davvero gratuita?
Sì. L'API è gratuita da usare senza registrazione, senza carta di credito e senza chiavi API. Utilizziamo limiti di frequenza basati su IP per proteggere da abusi — attualmente 1000 conversioni per IP al giorno, con caricamenti di file fino a 200 MB. Potremmo introdurre tier a pagamento opzionali in futuro per quote più elevate, ma il tier gratuito rimarrà sempre.
Ho bisogno di una chiave API?
No. Il tier gratuito è completamente anonimo. Semplicemente invia richieste HTTP a /api/v1/* e sei dentro. La limitazione di frequenza è per indirizzo IP.
Quali formati di file sono supportati?
Tutti i formati supportati dal sito web: 55+ formati immagine (JPG, PNG, HEIC, AVIF, WebP, RAW, PSD, ecc.), 17+ formati audio (MP3, WAV, FLAC, M4A, OGG, ecc.), 30+ formati video (MP4, MOV, MKV, WebM, AVI, ecc.), 25+ formati documento (DOCX, PDF, EPUB, XLSX, ecc.), più 12 strumenti IA come upscaling, rimozione vocale, speech-to-text e rimozione dello sfondo.
Come funzionano i limiti di frequenza?
Ogni indirizzo IP ottiene 1000 richieste al giorno, 150 all'ora, con un cooldown di 1 secondo tra le richieste consecutive. Gli strumenti IA hanno limiti più ristretti (50–100 al giorno) perché costosi dal punto di vista computazionale. Ogni risposta include intestazioni X-RateLimit-* che mostrano la tua quota rimanente. Vedi /api/rate-limits per i dettagli completi.
Quanto tempo vengono conservati i file convertiti?
I file convertiti vengono memorizzati per 2 ore dopo la conversione, quindi eliminati automaticamente. Assicurati di scaricare il risultato tramite GET /api/v1/jobs/{job_id}/output entro quel periodo.
Posso elaborare più file in un'unica richiesta?
Sì. POST /api/v1/batch accetta fino a 20 file in una singola richiesta multipart e restituisce un batch_id che puoi controllare in polling in GET /api/v1/batches/{batch_id}. Ogni file nel batch conta singolarmente sulla tua quota giornaliera.
Qual è la differenza tra /api/v1/convert e /api/v1/tools/{slug}?
Usa /api/v1/convert per la conversione di formato (HEIC→JPG, MP4→MP3, DOCX→PDF, ecc.). Usa /api/v1/tools/{slug} per strumenti specializzati che non si adattano a uno scambio di formato semplice — upscaling IA, rimozione dello sfondo, isolamento vocale, speech-to-text, filigrana, sfocatura, ecc.