API: inici ràpid

Automatitza imatges i PDF amb l’API REST.

Accés i claus

Inicia sessió a Levomio i crea una clau a la configuració. Copia-la i substitueix YOUR_API_KEY al client escollit. Mantén la clau privada.

Gestiona les claus · API

API: inici ràpid

L’exemple converteix photo.png a WebP per 1 crèdit. Defineix LEVOMIO_API_KEY amb la teva clau i executa les ordres al mateix terminal. Calen Bash, curl i uuidgen.

1. Crea una tasca

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. Carrega la imatge

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. Inicia — màxim 1 crèdit

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. Obté el resultat

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

Repeteix l’última petició cada 1–2 segons fins que status sigui completed. Assigna a DOWNLOAD_PATH l’outputs[].downloadUrl del fitxer preparat i baixa’l amb aquesta ordre.

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

Preus en crèdits

Operació	Cost
Compressió o conversió d’imatges	1 crèdit per imatge i format de sortida
Imatges a PDF	1 crèdit per imatge original, en un PDF conjunt o separat
Compressió de PDF	1 crèdit per pàgina del PDF original, comptada pel servidor

10 imatges a WebP i AVIF costen 20 crèdits; 10 imatges en un PDF, 10; comprimir un PDF de 30 pàgines, 30.

Càrregues, pressupostos, consultes de saldo i estat, previsualitzacions, baixades i ZIP són gratuïts. No cal subscripció; preus i límits iguals per a tots els comptes.

Els crèdits es cobren en iniciar. maxCredits limita la despesa. Per a lots, consulta el total amb quote abans de start. Repeteix la mateixa tasca amb els mateixos ID i paràmetres per evitar pagar una tasca nova.

50.000.000 bytes per fitxer, 250 originals per tasca. Esborranys i resultats es conserven 2 hores; comprova expiresAt i baixa’ls a temps. Les quotes del web no s’apliquen a API/MCP.