API : démarrage rapide
Automatisez le traitement des images et PDF avec l’API REST.
Accès et clés
Connectez-vous à Levomio et créez une clé dans les paramètres. Copiez-la et remplacez YOUR_API_KEY dans la configuration du client choisi. Gardez-la privée.
Gérer les clés · APIAPI : démarrage rapide
Cet exemple convertit photo.png en WebP pour 1 crédit. Définissez LEVOMIO_API_KEY avec votre clé puis exécutez les commandes dans le même terminal. Bash, curl et uuidgen sont nécessaires.
1. Créer une tâche
export LEVOMIO_API_KEY='YOUR_API_KEY'
export LEVOMIO_ORIGIN='https://levomio.com'
TASK_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
INPUT_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
OPTIONS='{"formats":["webp"],"zip":{"enabled":true}}'
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" \
-H 'Content-Type: application/json' \
--data "{\"taskId\":\"$TASK_ID\",\"type\":\"convert\",\"options\":$OPTIONS}"2. Envoyer l’image
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID/inputs" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" \
-F "taskFileInputId=$INPUT_ID" -F 'position=0' -F '[email protected]'3. Lancer — 1 crédit maximum
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID/start" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" \
-H 'Content-Type: application/json' \
--data "{\"inputIds\":[\"$INPUT_ID\"],\"options\":$OPTIONS,\"maxCredits\":1}"4. Obtenir le résultat
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $LEVOMIO_API_KEY"Répétez la dernière requête toutes les 1–2 secondes jusqu’à status: completed. Définissez DOWNLOAD_PATH avec outputs[].downloadUrl du fichier prêt, puis téléchargez-le avec cette commande.
curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webpTarifs en crédits
| Opération | Coût |
|---|---|
| Compression ou conversion d’images | 1 crédit par image et format de sortie |
| Images en PDF | 1 crédit par image source, PDF fusionné ou séparé |
| Compression PDF | 1 crédit par page du PDF source, comptée par le serveur |
10 images en WebP et AVIF coûtent 20 crédits ; 10 images dans un PDF, 10 ; compresser un PDF de 30 pages, 30.
Envois, devis, consultations du solde et du statut, aperçus, téléchargements et ZIP sont gratuits. Aucun abonnement requis ; tarifs et limites identiques pour tous les comptes.
Les crédits sont débités au lancement. maxCredits fixe votre plafond. Pour un lot, obtenez le total avec quote avant start. Réessayez la même tâche avec les mêmes ID et paramètres pour éviter de payer une nouvelle tâche.
50 000 000 octets par fichier, 250 sources par tâche. Brouillons et résultats sont conservés 2 heures : vérifiez expiresAt et téléchargez à temps. Les quotas du site ne s’appliquent pas à l’API/MCP.