API: snel aan de slag
Automatiseer afbeeldingen en PDF’s met de REST-API.
Toegang en sleutels
Log in bij Levomio en maak een sleutel in de instellingen. Kopieer deze en vervang YOUR_API_KEY in je gekozen client. Houd de sleutel privé.
Sleutels beheren · APIAPI: snel aan de slag
Het voorbeeld converteert photo.png naar WebP voor 1 credit. Stel LEVOMIO_API_KEY in op je sleutel en voer de opdrachten in dezelfde terminal uit. Je hebt Bash, curl en uuidgen nodig.
1. Taak maken
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. Afbeelding uploaden
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. Starten — maximaal 1 credit
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. Resultaat ophalen
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $LEVOMIO_API_KEY"Herhaal het laatste verzoek elke 1–2 seconden tot status completed is. Zet DOWNLOAD_PATH op outputs[].downloadUrl van het gereedstaande bestand en download het met deze opdracht.
curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webpPrijzen in credits
| Bewerking | Kosten |
|---|---|
| Afbeeldingen comprimeren of converteren | 1 credit per afbeelding en uitvoerformaat |
| Afbeeldingen naar PDF | 1 credit per bronafbeelding, samengevoegd of afzonderlijk |
| PDF-compressie | 1 credit per pagina van de bron-PDF, geteld door de server |
10 afbeeldingen naar WebP en AVIF kosten 20 credits; 10 afbeeldingen in één PDF kosten 10; een PDF met 30 pagina’s comprimeren kost 30.
Uploads, prijsopgaven, saldo- en statuscontroles, voorbeelden, downloads en ZIP zijn gratis. Geen abonnement nodig; prijzen en limieten zijn voor alle accounts gelijk.
Credits worden bij de start afgeschreven. maxCredits is je bestedingslimiet. Vraag voor batches het totaal met quote op vóór start. Herhaal dezelfde taak met dezelfde ID’s en parameters om niet voor een nieuwe taak te betalen.
50.000.000 bytes per bestand, 250 bronbestanden per taak. Concepten en resultaten blijven 2 uur beschikbaar; controleer expiresAt en download op tijd. Websitequota gelden niet voor API/MCP.