Перейти до вмісту
Статті

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.