GeraikitaGeraikita AI
MenüAuthentifizierung

Authentifizierung

Jeder Request wird mit deinem API-Key authentifiziert, der mit gk- beginnt. Die Kosten werden vom GeraiPoints-Guthaben des Kontos abgezogen, dem der Key gehört.

API-Key senden

Sende den Key über einen der folgenden Header. Beide funktionieren an allen kostenpflichtigen Endpoints.

HeaderFormatHinweis
AuthorizationBearer gk-…Standard bei Clients im OpenAI-Format (https://ai.geraikita.com/v1).
x-api-keygk-…Standard bei Clients im Anthropic-Format (https://ai.geraikita.com).
anthropic-version2023-06-01Wird vom Anthropic SDK automatisch gesendet; gib ihn mit, wenn du /v1/messages direkt aufrufst.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

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

Fehlt der Key, ist er falsch oder widerrufen, antwortet der Server mit 401 und 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 erstellen & widerrufen

  1. Öffne das Dashboard und wähle API-Key erstellen.
  2. Gib einen Namen, der den Einsatz beschreibt (z. B. laptop-kantor oder server-produksi), und wähle bei Bedarf die erlaubten Modelle.
  3. Kopiere den Key und bewahre ihn sicher auf. Zum Widerrufen klicke in der Key-Liste auf Widerrufen — Requests mit diesem Key werden sofort abgelehnt.
Der Roh-Key wird nur einmal bei der Erstellung angezeigt und ist danach nicht mehr einsehbar. Maximal 20 aktive Keys pro Konto — widerrufe einen alten Key, um einen neuen zu erstellen.

Key auf bestimmte Modelle beschränken

Jeder Key lässt sich auf eine Liste bestimmter Modelle beschränken (Allowlist). Eine leere Liste bedeutet, dass alle Modelle erlaubt sind. Requests an Modelle außerhalb der Liste erhalten 403 permission_error, und GET /v1/models mit diesem Key zeigt nur die erlaubten Modelle. Nutze das für Keys, die du mit Apps oder Teams teilst, um die Kosten im Griff zu behalten.

Key-Typen

KeyFürBase-URL
gk-Kostenpflichtige API — wird von GeraiPoints abgezogen. Erstellt im Dashboard.https://ai.geraikita.com/v1
gk- (bansos)Free Tier — Tageskontingent, separater Endpoint. Siehe Free Tier (Bansos). Nicht an kostenpflichtigen Endpoints nutzbar und umgekehrt.https://ai.geraikita.com/v1/claude
gkr-Reseller-Programm — verwaltet auf der Seite Reseller.—

Keys sicher aufbewahren

  • Lege Keys niemals in Frontend-Code ab (Browser, mobile Apps). Rufe die API von deinem eigenen Server auf.
  • Speichere Keys in Umgebungsvariablen oder einem Secret Manager und committe sie niemals in ein Repository.
  • Nutze einen Key pro App oder Gerät, damit die Nutzung leicht nachvollziehbar ist und ein Key widerrufen werden kann, ohne die anderen zu stören.
  • Verdacht auf ein Key-Leck? Widerrufe ihn sofort im Dashboard und erstelle einen neuen.