Démarrez en 2 minutes.

L'API Geraikita AI prend en charge deux formats à la fois : OpenAI Chat Completions et Anthropic Messages. Utilisez le SDK OpenAI, le SDK Anthropic, Claude Code CLI, Cline et d'autres outils — changez simplement l'URL de base et la clé API.

Authentification

Chaque requête transporte votre clé API gk- dans l'en-tête Authorization: Bearer gk-.... Les clés sont créées dans le tableau de bord et affichées une seule fois à la création — conservez-les en lieu sûr. Vous pouvez restreindre chaque clé à des modèles précis (liste d'autorisation).

Première requête

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.geraikita.com/v1",
    api_key="gk-xxxxxxxx",
)
resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

Claude Code CLI

Claude Code utilise le format Anthropic. Réglez l'URL de base sur la racine (https://ai.geraikita.com — sans /v1), puis lancez claude. Utilisez les modèles claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# URL de base = RACINE sans /v1 (Claude Code ajoute /v1/messages lui-même)
export ANTHROPIC_BASE_URL="https://ai.geraikita.com"
export ANTHROPIC_AUTH_TOKEN="gk-xxxxxxxx"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

Cline et autres outils

OpenCode

OpenCode lit ses providers dans un fichier de configuration. Déclarez Geraikita comme provider compatible OpenAI dans ~/.config/opencode/opencode.json, ou dans un opencode.json de projet.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "geraikita": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Geraikita AI",
      "options": {
        "baseURL": "https://ai.geraikita.com/v1",
        "apiKey": "{env:GERAIKITA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.6-sol": { "name": "GPT 5.6 Sol" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }
      }
    }
  }
}

Exportez ensuite votre clé et lancez OpenCode. Choisissez le modèle avec /models — il apparaît sous le nom geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Important : les clés sous models sont envoyées telles quelles à l'API, elles doivent donc correspondre exactement aux ids publics des modèles Geraikita.

Rappel : écrivez le nom du modèle exactement comme sur la page des tarifs, sans préfixe.

9router

9router est un proxy local qui répartit les requêtes entre plusieurs providers et écoute sur http://localhost:20128. Vous ne pointez pas vos outils directement vers Geraikita : vous déclarez Geraikita comme l'un des providers upstream de 9router.

1. Ouvrez le dashboard 9router sur http://localhost:20128/dashboard.
2. Allez dans Providers et ajoutez un endpoint custom OpenAI-compatible : Base URL https://ai.geraikita.com/v1, clé API gk-xxxxxxxx.
3. Vos outils restent pointés sur 9router (http://localhost:20128/v1) ; il suffit d'y choisir un modèle Geraikita — 9router transmet ces requêtes à Geraikita.

# votre outil reste pointé sur 9router, pas sur Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Vous gardez ainsi le routage et le fallback multi-providers de 9router, tandis que les tokens sont payés avec vos GeraiPoints Geraikita.

Rappel : écrivez le nom du modèle exactement comme sur la page des tarifs, sans préfixe.

Hermes

Hermes (le Hermes Agent de NousResearch) fonctionne avec n'importe quel endpoint compatible OpenAI. Pointez-le vers Geraikita dans ~/.hermes/config.yaml.

model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # ou placez-la dans ~/.hermes/.env

Ou lancez hermes model, choisissez Custom OpenAI-compatible endpoint et saisissez la base URL et la clé — Hermes détecte ensuite lui-même les modèles disponibles via GET https://ai.geraikita.com/v1/models.

Rappel : écrivez le nom du modèle exactement comme sur la page des tarifs, sans préfixe.

GeraiPoints

Liste des modèles

Les valeurs de model que vous pouvez envoyer. Consultez la page des tarifs pour les tarifs de chaque modèle.

Créer une clé API

Codes d'erreur