İçeriğe atla
Makaleler

API: hızlı başlangıç

Görsel ve PDF işlemeyi REST API ile otomatikleştirin.

Erişim ve anahtarlar

Levomio’da oturum açın ve ayarlardan bir anahtar oluşturun. Kopyalayıp seçtiğiniz istemcideki YOUR_API_KEY yerine yazın. Anahtarı gizli tutun.

Anahtarları yönetin · API

API: hızlı başlangıç

Örnek, photo.png dosyasını 1 kredi karşılığında WebP’ye dönüştürür. LEVOMIO_API_KEY değerini anahtarınızla ayarlayın ve komutları aynı terminalde çalıştırın. Bash, curl ve uuidgen gereklidir.

1. Görev oluşturun

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. Görseli yükleyin

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. Başlatın — en fazla 1 kredi

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. Sonucu alın

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY"

status değeri completed olana kadar son isteği 1–2 saniyede bir tekrarlayın. DOWNLOAD_PATH değerini hazır dosyanın outputs[].downloadUrl alanıyla ayarlayıp aşağıdaki komutla indirin.

curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webp

Kredi fiyatları

İşlemMaliyet
Görsel sıkıştırma veya dönüştürmeGörsel ve çıktı biçimi başına 1 kredi
Görsellerden PDFBirleştirilmiş veya ayrı PDF için kaynak görsel başına 1 kredi
PDF sıkıştırmaSunucunun saydığı kaynak PDF sayfası başına 1 kredi

10 görseli WebP ve AVIF’e dönüştürmek 20 kredi; 10 görseli bir PDF yapmak 10; 30 sayfalık PDF’yi sıkıştırmak 30 kredi tutar.

Yüklemeler, fiyat hesaplamaları, bakiye ve durum sorguları, önizlemeler, indirmeler ve ZIP ücretsizdir. Abonelik gerekmez; fiyatlar ve sınırlar tüm hesaplarda aynıdır.

Krediler işleme başladığında harcanır. maxCredits harcama sınırını belirler. Toplu işlemlerde start öncesinde quote ile toplamı öğrenin. Yeni görev ücreti ödememek için aynı görevi, ID’leri ve parametreleri kullanarak yeniden deneyin.

Dosya başına 50.000.000 bayt, görev başına 250 kaynak. Taslak ve sonuçlar 2 saat saklanır; expiresAt değerini kontrol edip zamanında indirin. Site kotaları API/MCP için geçerli değildir.