API CleverUtils
Une API REST publique et gratuite pour convertir des fichiers. Convertissez des images, audio, vidéo, documents et PDF — plus des outils IA comme la montée en gamme, la suppression de l'arrière-plan, l'isolation vocale et la transcription vocale — avec une seule requête HTTP. Réponses JSON, limites de débit généreuses, support des lots.
Convertir un fichier avec une seule commande cURL
Pas d'inscription. Pas de clé API. Il suffit de POSTer un fichier et d'obtenir un job en retour.
curl -X POST https://cleverutils.com/api/v1/convert \
-F "[email protected]" \
-F "to_format=jpg"
Réponse (enveloppe canonique) :
{
"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"
}
}
Puis téléchargez le résultat :
curl -o photo.jpg https://cleverutils.com/api/v1/jobs/5f8c.../output
Pourquoi utiliser l'API ?
Gratuit, sans inscription
Pas de clés API, pas de OAuth, pas de carte de crédit. Juste HTTP. Limites de débit généreuses basées sur l'adresse IP.
Tous les formats
55+ formats image, 17+ formats audio, 30+ formats vidéo, 25+ formats document. Plus 12 outils IA.
Traitement par lots
Envoyez jusqu'à 20 fichiers dans une seule requête. Parfait pour les galeries de photos, les mémos vocaux et les archives de documents.
Asynchrone-compatible
Obtenez un job_id immédiatement, interrogez le statut. Ou attendez de manière synchrone pour les petits fichiers.
Uploads de 200 Mo
Limite supérieure à celle du site web. Conçu pour la vidéo, les photos RAW et les gros documents.
Même moteur que le site
ImageMagick, FFmpeg, LibreOffice, Real-ESRGAN, Demucs, Whisper. Testé au combat sur des millions de fichiers.
Endpoints en un coup d'œil
Référence complète des endpoints →
Faits clés
- Authentification : aucune requise. Limitation anonyme basée sur l'adresse IP.
- Quota par défaut : 1000 requêtes par jour par adresse IP, 150 par heure, cooldown d'une seconde entre les requêtes.
- Quotas des outils IA : 50–100 par jour par adresse IP (calcul intensif).
- Limite de taille de fichier : 200 Mo par fichier.
- Limite de lot : 20 fichiers par requête
POST /api/v1/batch. - Rétention des jobs : les fichiers convertis sont supprimés après 2 heures — téléchargez rapidement.
- CORS :
Access-Control-Allow-Origin: *— fonctionne depuis n'importe quelle origine de navigateur. - Versioning : basé sur l'URL (
/api/v1/). Les modifications incompatibles iront en v2 avec au moins 6 mois de préavis. - Statut : voir /api/status pour la santé en temps réel.
Documentation
Questions fréquemment posées
L'API CleverUtils est-elle vraiment gratuite ?
Oui. L'API est gratuite sans inscription, sans carte de crédit et sans clés API. Nous utilisons des limites de débit basées sur l'adresse IP pour protéger contre les abus — actuellement 1000 conversions par adresse IP par jour, avec des uploads de fichiers jusqu'à 200 Mo. Nous pourrions introduire des niveaux payants facultatifs à l'avenir pour des quotas supérieurs, mais le niveau gratuit restera toujours.
Ai-je besoin d'une clé API ?
Non. Le niveau gratuit est entièrement anonyme. Il suffit d'envoyer des requêtes HTTP à /api/v1/* et c'est parti. La limitation est par adresse IP.
Quels formats de fichiers sont supportés ?
Tous les formats supportés par le site : 55+ formats image (JPG, PNG, HEIC, AVIF, WebP, RAW, PSD, etc.), 17+ formats audio (MP3, WAV, FLAC, M4A, OGG, etc.), 30+ formats vidéo (MP4, MOV, MKV, WebM, AVI, etc.), 25+ formats document (DOCX, PDF, EPUB, XLSX, etc.), plus 12 outils IA comme la montée en gamme, la suppression vocale, la transcription vocale et la suppression d'arrière-plan.
Comment fonctionnent les limites de débit ?
Chaque adresse IP reçoit 1000 requêtes par jour, 150 par heure, avec un cooldown d'une seconde entre les requêtes consécutives. Les outils IA ont des limites plus strictes (50–100 par jour) car ils sont coûteux en calcul. Chaque réponse inclut des en-têtes X-RateLimit-* montrant votre quota restant. Voir /api/rate-limits pour les détails complets.
Combien de temps les fichiers convertis sont-ils conservés ?
Les fichiers convertis sont stockés pendant 2 heures après la conversion, puis automatiquement supprimés. Assurez-vous de télécharger le résultat via GET /api/v1/jobs/{job_id}/output dans cette fenêtre.
Puis-je traiter par lots plusieurs fichiers dans une seule requête ?
Oui. POST /api/v1/batch accepte jusqu'à 20 fichiers dans une seule requête multipart et retourne un batch_id que vous pouvez interroger à GET /api/v1/batches/{batch_id}. Chaque fichier du lot compte individuellement dans votre quota quotidien.
Quelle est la différence entre /api/v1/convert et /api/v1/tools/{slug} ?
Utilisez /api/v1/convert pour la conversion de format (HEIC→JPG, MP4→MP3, DOCX→PDF, etc.). Utilisez /api/v1/tools/{slug} pour les outils spécialisés qui ne correspondent pas à un simple échange de format — montée en gamme IA, suppression d'arrière-plan, isolation vocale, transcription vocale, filigrane, flou, etc.