GET /api/v1/models butuh API key. Key dikenali dari dua header — pilih salah satu.
Format key
- Selalu diawali
vg_, diikuti 32 karakter heksadesimal. Bearertidak 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 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.