GeraikitaGeraikita AI
MenuAuthentification

Authentification

Chaque requête est authentifiée avec votre clé API commençant par gk-. Le coût est débité du solde de GeraiPoints du compte propriétaire de la clé.

Envoyer la clé API

Envoyez la clé dans l’un des en-têtes suivants. Les deux fonctionnent sur tous les endpoints payants.

En-têteFormatRemarques
AuthorizationBearer gk-…Par défaut dans les clients au format OpenAI (https://ai.geraikita.com/v1).
x-api-keygk-…Par défaut dans les clients au format Anthropic (https://ai.geraikita.com).
anthropic-version2023-06-01Envoyé automatiquement par le SDK Anthropic ; à inclure si vous appelez /v1/messages directement.
HTTP headers
# OpenAI
Authorization: Bearer gk-xxxxxxxx

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

Si la clé est absente, erronée ou révoquée, le serveur répond 401 avec le type authentication_error :

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

Créer et révoquer des clés

  1. Ouvrez le Tableau de bord puis choisissez Créer une clé API.
  2. Donnez-lui un nom qui décrit son usage (par ex. laptop-kantor ou server-produksi) et, si besoin, choisissez les modèles autorisés.
  3. Copiez la clé et conservez-la en lieu sûr. Pour la révoquer, cliquez sur Révoquer dans la liste des clés : les requêtes avec cette clé sont refusées immédiatement.
La clé en clair n’est affichée qu’une seule fois à sa création et ne peut plus être consultée ensuite. Maximum 20 clés actives par compte : révoquez une ancienne clé pour en créer une nouvelle.

Restreindre une clé à certains modèles

Chaque clé peut être restreinte à une liste de modèles (allowlist). Une liste vide signifie que tous les modèles sont autorisés. Les requêtes vers un modèle hors liste reçoivent 403 permission_error, et GET /v1/models avec cette clé n’affiche que les modèles autorisés. Utilisez-la pour les clés partagées avec des applications ou des équipes afin de maîtriser les dépenses.

Types de clés

CléUsageURL de base
gk-API payante — débitée en GeraiPoints. Créée dans le Tableau de bord.https://ai.geraikita.com/v1
gk- (bansos)Offre gratuite — quota quotidien, endpoint séparé. Voir Offre gratuite (Bansos). Ne fonctionne pas sur les endpoints payants, et inversement.https://ai.geraikita.com/v1/claude
gkr-Programme revendeur — géré sur la page Reseller.—

Protéger votre clé

  • Ne placez jamais la clé dans du code front-end (navigateur, application mobile). Appelez l’API depuis votre propre serveur.
  • Stockez la clé dans des variables d’environnement ou un gestionnaire de secrets, et ne la commitez jamais dans un dépôt.
  • Utilisez une clé par application ou par appareil : l’usage est plus facile à suivre et vous pouvez révoquer une clé sans affecter les autres.
  • Vous soupçonnez une fuite ? Révoquez immédiatement la clé dans le Tableau de bord puis créez-en une nouvelle.