Przejdź do treści
Artykuły

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 · API

API: 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.webp

Ceny w kredytach

OperacjaKoszt
Kompresja lub konwersja obrazów1 kredyt za obraz i format wyjściowy
Obrazy do PDF1 kredyt za obraz źródłowy, w połączonym lub osobnym PDF
Kompresja PDF1 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.