Passer au contenu
Articles

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 · API

API : 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.webp

Tarifs en crédits

OpérationCoût
Compression ou conversion d’images1 crédit par image et format de sortie
Images en PDF1 crédit par image source, PDF fusionné ou séparé
Compression PDF1 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.