Dokumentasi API

Kontrak kecil, perilaku tegas.

Header-only authentication, body maksimal 1 MiB, bounded fallback, dan query credential selalu ditolak.

Authentication

Gunakan Authorization: Bearer <key> atau x-api-key. Query ?key= tidak pernah diterima.

Endpoints

GET/health/live

Proses router hidup.

GET/health/ready

Minimal satu route upstream dikonfigurasi.

GET/v1/models

Daftar exact qualified model ID.

POST/v1/chat/completions

Chat JSON atau SSE passthrough.

POST/v1/responses

Responses API melalui router yang sama.

Streaming

SSE mempertahankan lease akun sampai body selesai dibaca dan mengirim header text/event-stream, no-cache, serta X-Accel-Buffering: no.

Fallback dan error

Network error, 5xx, 408, 429, dan kegagalan credential upstream dapat fallback. Buyer 4xx selain itu dikembalikan tanpa physical send kedua.