Преминете към съдържанието
Статии

API: бърз старт

Автоматизирайте обработката на изображения и PDF чрез REST API.

Достъп и ключове

Влезте в Levomio и създайте ключ в настройките. Копирайте го и заменете YOUR_API_KEY в избрания клиент. Пазете ключа в тайна.

Управление на ключове · API

API: бърз старт

Примерът преобразува photo.png във WebP за 1 кредит. Задайте LEVOMIO_API_KEY с вашия ключ и изпълнете командите в един терминал. Необходими са Bash, curl и uuidgen.

1. Създайте задача

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. Качете изображението

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. Стартирайте — до 1 кредит

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. Получете резултата

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

Повтаряйте последната заявка на всеки 1–2 секунди, докато status стане completed. Задайте DOWNLOAD_PATH на outputs[].downloadUrl на готовия файл и го изтеглете с командата по-долу.

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

Цени в кредити

ОперацияЦена
Компресиране или конвертиране на изображения1 кредит за изображение и изходен формат
Изображения в PDF1 кредит за изходно изображение, в общ или отделен PDF
Компресиране на PDF1 кредит за страница от изходния PDF, преброена от сървъра

10 изображения в WebP и AVIF струват 20 кредита; 10 изображения в един PDF — 10; компресиране на PDF с 30 страници — 30.

Качвания, оценки, проверки на баланс и статус, прегледи, изтегляния и ZIP са безплатни. Не е нужен абонамент; цените и лимитите са еднакви за всички акаунти.

Кредитите се начисляват при стартиране на обработката. maxCredits ограничава разхода. За група файлове проверете сумата с quote преди start. Повтаряйте същата задача със същите ID и параметри, за да не плащате за нова.

50 000 000 байта на файл, 250 източника на задача. Чернови и резултати се пазят 2 часа; проверявайте expiresAt и изтегляйте навреме. Квотите на сайта не важат за API/MCP.