Перейти к содержимому
Статьи

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.