Langsung ke konten utama
Setiap endpoint kecuali GET /api/v1/models butuh API key. Key dikenali dari dua header — pilih salah satu.

Format key

  • Selalu diawali vg_, diikuti 32 karakter heksadesimal.
  • Bearer tidak peka kapital (bearer vg_... juga diterima).
  • Prefix vg_ wajib. Key tanpa prefix ditolak walau isinya benar.
  • Key dibuat di halaman API key dashboard; raw key hanya muncul sekali.

Kegagalan autentikasi

Semua kegagalan autentikasi memakai bentuk body yang sama: { "error": "..." }. Tidak ada code numerik — pakai status HTTP untuk membedakan.

Keamanan

Kirim hanya lewat HTTPS. Key tidak boleh lewat URL http:// atau di tempel di query string.
Beri nama key per lingkungan. staging, prod-cron, lokal-andi — supaya pencabutan tidak kena sistem lain.
Jangan pakai key dari dashboard di browser pengguna akhir. Setiap request API memotong kredit akun pemilik key. Untuk produk yang dipakai banyak pengguna, simpan key di server kamu dan perbolehkan akses hanya dari sana.
Jangan simpan key di aplikasi mobile atau bundle frontend yang bisa dibongkar. Kalau pernah bocor, cabut dan buat baru — rotasi adalah satu-satunya cara pencabutan.

Endpoint yang tidak butuh key

GET /api/v1/models boleh dipanggil tanpa autentikasi karena hanya berisi katalog publik. Kalau aplikasimu menampilkan harga atau saldo, tetap kirim key. Lanjut ke Base URL.