Ga naar inhoud
Artikelen

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

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

Prijzen in credits

BewerkingKosten
Afbeeldingen comprimeren of converteren1 credit per afbeelding en uitvoerformaat
Afbeeldingen naar PDF1 credit per bronafbeelding, samengevoegd of afzonderlijk
PDF-compressie1 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.