API: inicio rápido

Automatiza el procesamiento de imágenes y PDF con la API REST.

Acceso y claves

Inicia sesión en Levomio y crea una clave en los ajustes. Cópiala y sustituye YOUR_API_KEY en la configuración del cliente elegido. Mantén la clave privada.

Gestionar claves · API

API: inicio rápido

El ejemplo convierte photo.png a WebP por 1 crédito. Define LEVOMIO_API_KEY con tu clave y ejecuta los comandos en el mismo terminal. Necesitas Bash, curl y uuidgen.

1. Crea una tarea

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. Carga la imagen

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áximo 1 crédito

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én el resultado

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

Repite la última solicitud cada 1–2 segundos hasta que status sea completed. Asigna a DOWNLOAD_PATH el outputs[].downloadUrl del archivo listo y descárgalo con este comando.

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

Precios en créditos

Operación	Coste
Compresión o conversión de imágenes	1 crédito por imagen y formato de salida
Imágenes a PDF	1 crédito por imagen original, en un PDF conjunto o separado
Compresión de PDF	1 crédito por página del PDF original, contada por el servidor

10 imágenes a WebP y AVIF cuestan 20 créditos; 10 imágenes a un PDF, 10; comprimir un PDF de 30 páginas, 30.

Las cargas, presupuestos, consultas de saldo y estado, vistas previas, descargas y ZIP son gratuitos. No se necesita suscripción; los precios y límites son iguales para todas las cuentas.

Los créditos se cobran al iniciar el procesamiento. maxCredits limita el gasto. Para lotes, consulta el total con quote antes de start. Reintenta la misma tarea con los mismos ID y parámetros para evitar pagar otra tarea.

50.000.000 bytes por archivo y 250 originales por tarea. Los borradores y resultados duran 2 horas; comprueba expiresAt y descarga a tiempo. Las cuotas del sitio no se aplican a API/MCP.