Error Codes
Semua error mengikuti format: { "error": { "code": "...", "message": "..." } }.
| Code | HTTP | Deskripsi |
|---|---|---|
| unauthorized | 401 | Missing/invalid API key |
| forbidden | 403 | Key lacks required scope |
| not_found | 404 | Resource tidak ditemukan |
| validation_error | 400 | Request body / params tidak valid |
| rate_limited | 429 | Rate limit per-key atau per-user tercapai |
| negative_balance_locked | 402 | Balance pro negatif — top up untuk resume |
| insufficient_pro_credits | 402 | Pro credits tidak cukup untuk reservasi |
| idempotency_conflict | 409 | Idempotency key sama, body berbeda |
| idempotency_key_in_use | 409 | Idempotency key sama, body sama, tapi request pertama masih diproses — ulangi nanti untuk menerima respons aslinya |
| use_async | 409 | Gunakan mode=async (sync tidak tersedia untuk request ini) |
| unprocessable_document | 422 | Dokumen tidak bisa diproses (format tidak didukung, belum selesai ekstraksi) |
| quota_exceeded | 429 | Max in-flight async runs (10/user) tercapai |
| output_not_ready | 422 | Run belum selesai atau output bukan file |
| payload_too_large | 413 | File melebihi batas ukuran — 50MB untuk presigned upload (/documents, /reference-documents), 4MB total untuk multipart files[] inline pada /runs |
| upstream_unavailable | 502 | Model evaluasi tidak mengembalikan hasil yang bisa dipakai, bahkan setelah retry otomatis. Sementara (transient) — ulangi request yang sama (aman memakai Idempotency-Key yang sama); ada header Retry-After dan field retryable: true. Kredit yang direservasi direfund |
| output_truncated | 422 | Output model terpotong karena anggaran token output habis. Mengulang request yang sama tidak membantu — sederhanakan output schema/prompt workflow atau hubungi support. Kredit direfund |
| internal_error | 500 | Server error — kami yang salah (direfund jika ada charge) |