API: быстрый старт
Автоматизируйте обработку изображений и PDF через REST API.
Доступ и ключи
Войдите в Levomio и создайте ключ в настройках. Скопируйте его и замените YOUR_API_KEY в настройках выбранного клиента. Не публикуйте ключ.
Управление ключами · APIAPI: быстрый старт
Пример конвертирует 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 кредит за изображение и выходной формат |
| Изображения в PDF | 1 кредит за исходное изображение, в общем или отдельном PDF |
| Сжатие PDF | 1 кредит за страницу исходного PDF; количество проверяет сервер |
10 изображений в WebP и AVIF стоят 20 кредитов. 10 изображений в один PDF — 10. Сжатие PDF из 30 страниц — 30.
Загрузка, оценка цены, проверка баланса и статуса, превью, скачивание и ZIP бесплатны. Подписка не нужна; цены и лимиты одинаковы для всех аккаунтов.
Кредиты списываются при запуске обработки. maxCredits задаёт предел расходов. Для пакета файлов узнайте сумму через quote перед start. При повторе используйте ту же задачу, ID и параметры, чтобы не оплачивать новую задачу.
50 000 000 байт на файл, 250 исходников на задачу. Черновики и результаты хранятся 2 часа; проверяйте expiresAt и скачивайте вовремя. Квоты сайта не распространяются на API/MCP.