API: szybki start
Automatyzuj przetwarzanie obrazów i PDF przez REST API.
Dostęp i klucze
Zaloguj się do Levomio i utwórz klucz w ustawieniach. Skopiuj go i zastąp YOUR_API_KEY w wybranym kliencie. Zachowaj klucz w tajemnicy.
Zarządzaj kluczami · APIAPI: szybki start
Przykład konwertuje photo.png do WebP za 1 kredyt. Ustaw LEVOMIO_API_KEY na swój klucz i wykonaj polecenia w tym samym terminalu. Potrzebujesz Bash, curl i uuidgen.
1. Utwórz zadanie
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. Prześlij obraz
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. Uruchom — maksymalnie 1 kredyt
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. Pobierz wynik
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $LEVOMIO_API_KEY"Powtarzaj ostatnie żądanie co 1–2 sekundy, aż status będzie completed. Ustaw DOWNLOAD_PATH na outputs[].downloadUrl gotowego pliku i pobierz go tym poleceniem.
curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webpCeny w kredytach
| Operacja | Koszt |
|---|---|
| Kompresja lub konwersja obrazów | 1 kredyt za obraz i format wyjściowy |
| Obrazy do PDF | 1 kredyt za obraz źródłowy, w połączonym lub osobnym PDF |
| Kompresja PDF | 1 kredyt za stronę źródłowego PDF, liczoną przez serwer |
10 obrazów do WebP i AVIF kosztuje 20 kredytów; 10 obrazów w jednym PDF — 10; kompresja 30-stronicowego PDF — 30.
Przesyłanie, wyceny, odczyt salda i statusu, podglądy, pobieranie i ZIP są bezpłatne. Subskrypcja nie jest wymagana; ceny i limity są jednakowe dla wszystkich kont.
Kredyty są pobierane przy uruchomieniu. maxCredits ogranicza wydatek. Dla partii plików sprawdź sumę przez quote przed start. Ponawiaj to samo zadanie z tymi samymi ID i parametrami, aby nie płacić za nowe.
50 000 000 bajtów na plik, 250 źródeł na zadanie. Szkice i wyniki są przechowywane przez 2 godziny; sprawdzaj expiresAt i pobieraj na czas. Limity strony nie dotyczą API/MCP.