API: avvio rapido

Automatizza immagini e PDF con l’API REST.

Accesso e chiavi

Accedi a Levomio e crea una chiave nelle impostazioni. Copiala e sostituisci YOUR_API_KEY nel client scelto. Mantieni la chiave privata.

Gestisci le chiavi · API

API: avvio rapido

L’esempio converte photo.png in WebP per 1 credito. Imposta LEVOMIO_API_KEY con la tua chiave ed esegui i comandi nello stesso terminale. Servono Bash, curl e uuidgen.

1. Crea un’attività

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. Carica l’immagine

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. Avvia — massimo 1 credito

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. Ottieni il risultato

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

Ripeti l’ultima richiesta ogni 1–2 secondi fino a status: completed. Imposta DOWNLOAD_PATH con outputs[].downloadUrl del file pronto e scaricalo con questo comando.

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

Prezzi in crediti

Operazione	Costo
Compressione o conversione di immagini	1 credito per immagine e formato di uscita
Immagini in PDF	1 credito per immagine originale, PDF unito o separato
Compressione PDF	1 credito per pagina del PDF originale, contata dal server

10 immagini in WebP e AVIF costano 20 crediti; 10 immagini in un PDF, 10; comprimere un PDF di 30 pagine, 30.

Caricamenti, preventivi, controlli di saldo e stato, anteprime, download e ZIP sono gratuiti. Nessun abbonamento richiesto; prezzi e limiti uguali per tutti gli account.

I crediti vengono addebitati all’avvio. maxCredits limita la spesa. Per gruppi di file, ottieni il totale con quote prima di start. Riprova la stessa attività con gli stessi ID e parametri per evitare di pagare una nuova attività.

50.000.000 byte per file, 250 originali per attività. Bozze e risultati durano 2 ore: controlla expiresAt e scarica in tempo. Le quote del sito non si applicano ad API/MCP.