GeraikitaGeraikita AI
MenuDémarrage rapide

Démarrage rapide

De zéro à la première réponse en trois étapes : préparez l’URL de base, créez une clé API, puis envoyez la requête.

URL de base

Les clients au format OpenAI utilisent une URL de base qui se termine par /v1. Les clients au format Anthropic utilisent la racine sans /v1, car leur SDK ajoute /v1/messages lui-même.

RéglageValeurUtilisé par
base_urlhttps://ai.geraikita.com/v1SDK OpenAI, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue
base_urlhttps://ai.geraikita.comSDK Anthropic, Claude Code CLI, Cline (Anthropic)
api_keygk-…Tous les clients — la clé se crée dans le Tableau de bord

Créer une clé API

  1. Connectez-vous à Geraikita AI.
  2. Rechargez des GeraiPoints sur la page Recharger (ou obtenez une clé gratuite via Bansos).
  3. Ouvrez le Tableau de bord → Créer une clé API. Copiez la clé gk-… : la clé en clair n’est affichée qu’une seule fois.
Stockez la clé dans une variable d’environnement, par ex. export GERAIKITA_API_KEY=gk-…, plutôt que de l’écrire directement dans le code.

Première requête

Choisissez le langage ou le SDK que vous utilisez. Tous les exemples appellent le modèle claude-sonnet-5 ; remplacez-le par un autre id de la liste des modèles.

curl https://ai.geraikita.com/v1/chat/completions \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Bonjour !"}]
  }'

La réponse est au même format JSON que l’API OpenAI (ou Anthropic, si vous utilisez /v1/messages), y compris l’objet usage contenant le nombre de tokens facturés.

Réponse en stream

Pour les réponses longues et les outils agentiques, activez stream afin que les fragments de réponse arrivent au fil de l’eau. Le serveur envoie immédiatement les en-têtes, puis des signaux keepalive en attendant le premier token. Réglez le timeout de votre application sur au moins 300 secondes.

curl https://ai.geraikita.com/v1/chat/completions -N \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "Bonjour !"}]
  }'

Étapes suivantes