GeraikitaGeraikita AI
MenuAuthenticatie

Authenticatie

Elke request wordt geauthenticeerd met je eigen API-key die begint met gk-. De kosten worden afgeschreven van het GeraiPoints-saldo van het account waar de key bij hoort.

API-key meesturen

Stuur de key mee in een van de volgende headers. Beide werken op alle betaalde endpoints.

HeaderFormaatToelichting
AuthorizationBearer gk-…Standaard bij clients in OpenAI-formaat (https://ai.geraikita.com/v1).
x-api-keygk-…Standaard bij clients in Anthropic-formaat (https://ai.geraikita.com).
anthropic-version2023-06-01Wordt automatisch meegestuurd door de Anthropic SDK; voeg hem toe als je /v1/messages rechtstreeks aanroept.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

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

Als de key ontbreekt, onjuist is of is ingetrokken, antwoordt de server met 401 en type authentication_error:

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

Keys aanmaken & intrekken

  1. Open het Dashboard en kies API-key aanmaken.
  2. Geef de key een naam die het gebruik beschrijft (bijv. laptop-kantor of server-produksi) en kies zo nodig welke modellen gebruikt mogen worden.
  3. Kopieer de key en bewaar hem op een veilige plek. Intrekken doe je met Intrekken in de lijst met keys — requests met die key worden direct geweigerd.
De volledige key wordt maar één keer getoond bij het aanmaken en is daarna niet meer te zien. Maximaal 20 actieve keys per account — trek een oude key in om een nieuwe aan te maken.

Een key beperken tot bepaalde modellen

Elke key kan worden beperkt tot een lijst met bepaalde modellen (allowlist). Een lege lijst betekent dat alle modellen zijn toegestaan. Requests naar een model buiten de lijst krijgen 403 permission_error, en GET /v1/models met die key toont alleen de toegestane modellen. Gebruik dit voor keys die je deelt met apps of teams, zodat de kosten onder controle blijven.

Soorten keys

KeyVoorBase URL
gk-Betaalde API — afgeschreven van GeraiPoints. Aangemaakt in het Dashboard.https://ai.geraikita.com/v1
gk- (bansos)Gratis tier — dagquotum, apart endpoint. Zie Gratis tier (Bansos). Werkt niet op betaalde endpoints, en andersom.https://ai.geraikita.com/v1/claude
gkr-Resellerprogramma — beheerd op de pagina Reseller.—

Je key veilig houden

  • Zet je key nooit in front-endcode (browser, mobiele app). Roep de API aan vanaf je eigen server.
  • Bewaar de key in omgevingsvariabelen of een secretmanager, en commit hem nooit naar een repository.
  • Gebruik één key per app of apparaat, zodat je het gebruik makkelijk kunt volgen en één key kunt intrekken zonder de rest te raken.
  • Vermoed je dat een key is uitgelekt? Trek hem direct in via het Dashboard en maak een nieuwe aan.