API: início rápido

Acesso e chaves

Inicie sessão no Levomio e crie uma chave nas definições. Copie-a e substitua YOUR_API_KEY no cliente escolhido. Mantenha a chave privada.

API: início rápido

O exemplo converte photo.png para WebP por 1 crédito. Defina LEVOMIO_API_KEY com a sua chave e execute os comandos no mesmo terminal. Precisa de Bash, curl e 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"

Repita o último pedido a cada 1–2 segundos até status ser completed. Defina DOWNLOAD_PATH com outputs[].downloadUrl do ficheiro pronto e transfira-o com este comando.

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

Preços em créditos

10 imagens para WebP e AVIF custam 20 créditos; 10 imagens num PDF, 10; comprimir um PDF de 30 páginas, 30.

Carregamentos, orçamentos, consultas de saldo e estado, pré-visualizações, transferências e ZIP são gratuitos. Não é necessária subscrição; preços e limites iguais para todas as contas.