Kode Error

Semua error dikembalikan dalam format JSON dengan objek error:

{
  "error": {
    "message": "Penjelasan error",
    "type": "jenis_error",
    "code": "kode"
  }
}

Daftar error

Status	Kode / tipe	Penyebab	Yang perlu dilakukan
400	bad_request	Body request tidak valid, atau nama model tidak dikenal.	Periksa JSON dan nama model. Cocokkan dengan GET /v1/models.
401	AUTH_002	API key salah, sudah dibuat ulang atau dicabut, atau saldo habis.	Periksa header Authorization dan status key di dashboard.
403	–	Model sedang dinonaktifkan.	Pakai model lain dari katalog.
429	rate_limit_exceeded	Batas request per menit atau per hari paket terlampaui.	Tunggu sesuai Retry-After, atau upgrade paket.
5xx	–	Gangguan di sisi penyedia model atau server.	Coba lagi dengan exponential backoff.

Retry yang aman

Error 5xx dan gangguan jaringan biasanya sementara. Ulangi request dengan jeda yang makin panjang. OpenAI SDK sudah melakukan ini otomatis; Anda bisa mengatur jumlah percobaannya:

client = OpenAI(
    base_url="https://router.rnevio.com/v1",
    api_key="sk-...",
    max_retries=3,
    timeout=60,
)

Jangan me-retry error 400, 401, dan 429 secara otomatis. Hasilnya akan tetap sama sampai penyebabnya diperbaiki.

Melaporkan masalah

Kalau error berlanjut, kirimkan ke tim kami:

1. Waktu kejadian (beserta zona waktu).
2. Status HTTP dan isi error.message.
3. Nilai correlation_id jika ada di response.

Jangan pernah mengirim API key Anda saat melapor.