GeraikitaGeraikita AI
MenuAutentikasi

Autentikasi

Setiap permintaan diautentikasi dengan API key milikmu yang berawalan gk-. Biaya dipotong dari saldo GeraiPoints akun pemilik key.

Mengirim API key

Kirim key lewat salah satu header berikut. Keduanya berlaku di semua endpoint berbayar.

HeaderFormatKeterangan
AuthorizationBearer gk-…Bawaan klien format OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Bawaan klien format Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01Dikirim otomatis oleh SDK Anthropic; sertakan bila memanggil /v1/messages langsung.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

# Anthropic
x-api-key: gk-xxxxxxxx
anthropic-version: 2023-06-01

Bila key tidak dikirim, salah, atau sudah dicabut, server membalas 401 dengan type authentication_error:

401 Unauthorized
{
  "error": {
    "message": "API key tidak valid atau tidak dikenali. Pastikan key gk- kamu benar.",
    "type": "authentication_error",
    "code": null
  }
}

Membuat & mencabut key

  1. Buka Dashboard lalu pilih Buat API key.
  2. Beri nama yang menjelaskan pemakaiannya (mis. laptop-kantor atau server-produksi) dan, bila perlu, pilih model yang boleh dipakai.
  3. Salin key dan simpan di tempat aman. Untuk mencabut, tekan Cabut di daftar key — permintaan dengan key itu langsung ditolak.
Key mentah hanya ditampilkan sekali saat dibuat dan tidak bisa dilihat lagi. Maksimal 20 key aktif per akun — cabut key lama untuk membuat yang baru.

Membatasi key ke model tertentu

Setiap key bisa dibatasi ke daftar model tertentu (allowlist). Daftar kosong berarti semua model boleh dipakai. Permintaan ke model di luar daftar dibalas 403 permission_error, dan GET /v1/models dengan key itu hanya menampilkan model yang diizinkan. Gunakan ini untuk key yang dibagikan ke aplikasi atau tim supaya biaya terkendali.

Jenis key

KeyUntukBase URL
gk-API berbayar — dipotong dari GeraiPoints. Dibuat di Dashboard.https://ai.geraikita.com/v1
gk- (bansos)Tier gratis — kuota harian, endpoint terpisah. Lihat Tier gratis (Bansos). Tidak bisa dipakai di endpoint berbayar, dan sebaliknya.https://ai.geraikita.com/v1/claude
gkr-Program reseller — dikelola di halaman Reseller.—

Menjaga key tetap aman

  • Jangan menaruh key di kode front-end (browser, aplikasi seluler). Panggil API dari server milikmu.
  • Simpan key di variabel lingkungan atau secret manager, dan jangan pernah meng-commit-nya ke repositori.
  • Pakai satu key per aplikasi atau perangkat, supaya pemakaian mudah dilacak dan satu key bisa dicabut tanpa mengganggu yang lain.
  • Curiga key bocor? Cabut segera di Dashboard lalu buat key baru.