Autentikasi

Semua endpoint inference (/v1/chat/completions, /v1/responses, /v1/messages, /v1/messages/count_tokens, /v1/models) memakai API key.

Memberi kunci

Dua skema header diterima di semua endpoint — pilih yang didukung tool-mu:

Authorization: Bearer sk-ngd-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

x-api-key: sk-ngd-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Format kunci selalu sk-ngd- + 40 karakter base62. Request dengan format salah ditolak sebelum menyentuh database (401 invalid_api_key / authentication_error).

Mengelola kunci

• Buat kunci di dashboard (maks 20 kunci aktif per akun). Nilai lengkap hanya tampil sekali — sesudahnya hanya prefix yang terlihat.
• Beri nama per keperluan (laptop-kerja, ci-deploy) supaya mudah dicabut satu per satu.
• Cabut kunci yang tidak dipakai. Pencabutan berlaku paling lambat 60 detik di seluruh instance.
• lastUsedAt diperbarui maksimal sekali per menit — jangan pakai field ini untuk audit per detik.

Batas yang perlu diketahui

• Kunci milik akun yang ditangguhkan ikut mati (401).
• /v1/messages/count_tokens butuh kunci yang valid, tapi gratis — tidak memotong credit.
• Jangan menaruh kunci di kode yang di-commit, di URL, atau di log. Kebocoran = cabut dan buat baru.