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.