API: mula pantas

Automatikkan pemprosesan imej dan PDF dengan REST API.

Akses dan kunci

Log masuk ke Levomio dan cipta kunci dalam tetapan. Salin dan gantikan YOUR_API_KEY dalam klien pilihan anda. Rahsiakan kunci.

Urus kunci · API

API: mula pantas

Contoh ini menukar photo.png kepada WebP dengan 1 kredit. Tetapkan LEVOMIO_API_KEY kepada kunci anda dan jalankan arahan dalam terminal yang sama. Bash, curl dan uuidgen diperlukan.

1. Cipta 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. Muat naik imej

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. Mulakan — maksimum 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. Dapatkan hasil

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

Ulang permintaan terakhir setiap 1–2 saat sehingga status menjadi completed. Tetapkan DOWNLOAD_PATH kepada outputs[].downloadUrl fail yang siap, kemudian muat turun dengan arahan berikut.

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

Harga dalam kredit

Operasi	Kos
Pemampatan atau penukaran imej	1 kredit bagi setiap imej dan format output
Imej kepada PDF	1 kredit bagi setiap imej sumber, PDF digabungkan atau berasingan
Pemampatan PDF	1 kredit bagi setiap halaman PDF sumber, dikira oleh pelayan

10 imej kepada WebP dan AVIF berharga 20 kredit; 10 imej dalam satu PDF, 10; pemampatan PDF 30 halaman, 30.

Muat naik, anggaran kos, semakan baki dan status, pratonton, muat turun serta ZIP adalah percuma. Langganan tidak diperlukan; harga dan had sama untuk semua akaun.

Kredit ditolak apabila pemprosesan bermula. maxCredits mengehadkan perbelanjaan. Untuk kelompok fail, semak jumlah dengan quote sebelum start. Cuba semula tugas yang sama dengan ID dan parameter yang sama agar tidak membayar tugas baharu.

50,000,000 bait setiap fail, 250 sumber setiap tugas. Draf dan hasil disimpan selama 2 jam; semak expiresAt dan muat turun tepat pada masanya. Kuota laman tidak terpakai kepada API/MCP.