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.