Error Codes

Semua error mengikuti format: { "error": { "code": "...", "message": "..." } }.

CodeHTTPDeskripsi
unauthorized401Missing/invalid API key
forbidden403Key lacks required scope
not_found404Resource tidak ditemukan
validation_error400Request body / params tidak valid
rate_limited429Rate limit per-key atau per-user tercapai
negative_balance_locked402Balance pro negatif — top up untuk resume
insufficient_pro_credits402Pro credits tidak cukup untuk reservasi
idempotency_conflict409Idempotency key sama, body berbeda
use_async409Gunakan mode=async (sync tidak tersedia untuk request ini)
unprocessable_document422Dokumen tidak bisa diproses (format tidak didukung, belum selesai ekstraksi)
quota_exceeded429Max in-flight async runs (10/user) tercapai
output_not_ready422Run belum selesai atau output bukan file
payload_too_large413File melebihi batas ukuran (50MB)
internal_error500Server error — kami yang salah (direfund jika ada charge)