Dokumentasi API

Semua yang kamu butuhkan untuk integrasi dengan gateway GubukAI.

Autentikasi

Semua request memerlukan header Authorization: Bearer gk-... dengan API key dari dashboard kamu. Key dapat dibuat dan dicabut kapan saja di menu API Key.

Base URL

Gunakan https://api.gubukai.id/v1 sebagai base URL. API kami kompatibel dengan format OpenAI, sehingga SDK OpenAI resmi dapat digunakan langsung dengan mengganti baseURL.

Kuota & rate limit

Setiap paket memiliki kuota request harian per model dan batas request per menit. Saat kuota habis, API mengembalikan status 429 dengan detail waktu reset.

Penanganan error

Error mengikuti format standar dengan kode HTTP: 401 untuk key tidak valid, 402 untuk saldo/paket habis, 429 untuk rate limit, dan 5xx untuk gangguan provider.

Integrasi dalam hitungan menit

API OpenAI-compatible. Cukup ganti base URL dan API key, kode lama kamu langsung jalan.

curl https://api.gubukai.id/v1/chat/completions \
  -H "Authorization: Bearer $GUBUKAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "Halo"}]}'

Baca Dokumentasi Lengkap