Lompat ke konten
Artikel

API: mulai cepat

Otomatiskan pengolahan gambar dan PDF dengan REST API.

Akses dan kunci

Masuk ke Levomio dan buat kunci di pengaturan. Salin lalu ganti YOUR_API_KEY pada klien pilihan Anda. Jaga kerahasiaan kunci.

Kelola kunci · API

API: mulai cepat

Contoh ini mengubah photo.png menjadi WebP dengan 1 kredit. Isi LEVOMIO_API_KEY dengan kunci Anda, lalu jalankan perintah di terminal yang sama. Diperlukan Bash, curl, dan uuidgen.

1. Buat tugas

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. Unggah gambar

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. Mulai — maksimal 1 kredit

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. Ambil hasil

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

Ulangi permintaan terakhir setiap 1–2 detik hingga status menjadi completed. Isi DOWNLOAD_PATH dengan outputs[].downloadUrl dari berkas yang siap, lalu unduh dengan perintah berikut.

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

Harga dalam kredit

OperasiBiaya
Kompresi atau konversi gambar1 kredit per gambar dan format keluaran
Gambar ke PDF1 kredit per gambar sumber, PDF gabungan atau terpisah
Kompresi PDF1 kredit per halaman PDF sumber, dihitung oleh server

10 gambar ke WebP dan AVIF berbiaya 20 kredit; 10 gambar ke satu PDF, 10; kompresi PDF 30 halaman, 30.

Unggahan, estimasi biaya, pemeriksaan saldo dan status, pratinjau, unduhan, dan ZIP gratis. Tidak perlu langganan; harga dan batas sama untuk semua akun.

Kredit dipotong saat pemrosesan dimulai. maxCredits membatasi pengeluaran. Untuk banyak berkas, periksa total dengan quote sebelum start. Ulangi tugas yang sama dengan ID dan parameter yang sama agar tidak membayar tugas baru.

50.000.000 byte per berkas, 250 sumber per tugas. Draf dan hasil disimpan 2 jam; periksa expiresAt dan unduh tepat waktu. Kuota situs tidak berlaku untuk API/MCP.