API: quick start

Access and keys

Sign in to Levomio and create a key in settings. Copy it and replace YOUR_API_KEY in your chosen client’s settings. Keep the key private.

API: quick start

This example converts photo.png to WebP for 1 credit. Set LEVOMIO_API_KEY to your key, then run the commands in the same terminal. You need Bash, curl and uuidgen.

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}"

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]'

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}"

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY"

Repeat the last request every 1–2 seconds until status is completed. Set DOWNLOAD_PATH to the ready file’s outputs[].downloadUrl, then download it with this command.

curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webp

Credit prices

10 images into WebP and AVIF cost 20 credits. 10 images into one PDF cost 10. Compressing a 30-page PDF costs 30.

Uploads, quotes, balance checks, status checks, previews, downloads and ZIP archives are free. No subscription is required; prices and limits are the same for every account.