Documentation

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.

URL de base (OpenAI)https://ai.geraikita.com/v1

URL de base (Anthropic)https://ai.geraikita.com

AuthentificationBearer gk-... (ou x-api-key: gk-...)

Important — n'écrivez pas /v1 deux fois.

OpenAIhttps://ai.geraikita.com/v1Les clients OpenAI ajoutent /chat/completions à l'URL de base — la base se termine donc par /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comLes clients Anthropic (Claude Code CLI, SDK Anthropic) ajoutent /v1/messages eux-mêmes — la base va donc sans /v1.

En cas d'erreur, le chemin devient /v1/v1/messages → erreur 400.

L'offre gratuite (Bansos) utilise une CLÉ SÉPARÉE — pas votre clé payante.

Une clé bansos doit d'abord être réclamée sur la page Bansos (connexion + vérification Telegram, gratuit, une fois par compte). Une clé gk- payante du tableau de bord ne fonctionne pas sur l'endpoint bansos, et inversement — les mélanger renvoie 401 unauthorized.

L'URL de base bansos est elle aussi différente de la payante ci-dessus :

URL de base bansoshttps://ai.geraikita.com/v1/claude

OpenAIhttps://ai.geraikita.com/v1/claude/chat/completions

Anthropic / Claude Code CLIANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeLe SDK ajoute /v1/messages lui-même → https://ai.geraikita.com/v1/claude/v1/messages.

Découverte des modèlesGET https://ai.geraikita.com/v1/claude/models

Tout le reste est exactement identique à l'endpoint payant.

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

Cline / Roo (OpenAI Compatible) : fournisseur OpenAI Compatible, URL de base https://ai.geraikita.com/v1, clé API gk-..., ID de modèle claude-sonnet-5.

Cline (Anthropic) : fournisseur Anthropic, URL de base https://ai.geraikita.com, clé API gk-....

Votre outil détecte-t-il les modèles automatiquement ? L'endpoint GET https://ai.geraikita.com/v1/models est disponible. S'il existe un champ « Gateway base URL » qui ajoute automatiquement /v1/models, remplissez-le avec https://ai.geraikita.com (racine) pour éviter que cela devienne /v1/v1/models.

GeraiPoints

1 GP = Rp1. Vous êtes facturé au token selon l'usage réel de chaque requête — aucun frais fixe par requête, seulement un petit minimum par requête pour chaque modèle (plancher). Rechargez des GeraiPoints dans le tableau de bord ; votre solde n'expire jamais et fonctionne avec n'importe quel modèle. Pas d'abonnements ni de quotas mensuels.

Liste des modèles

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

Écrivez le nom du modèle EXACTEMENT comme listé — sans préfixe. Envoyez claude-sonnet-5, pas gp/claude-sonnet-5 ni openai/claude-sonnet-5. Certains clients/CLI préfixent le modèle avec un nom de fournisseur (p. ex. un profil nommé gp → le modèle devient gp/claude-sonnet-5) → le résultat est 404 unknown model. Le préfixe gk- est destiné aux clés API (l'en-tête Authorization), pas aux noms de modèles.

Créer une clé API

Ouvrez le tableau de bord → Créer une clé API, donnez-lui un nom et (en option) restreignez-la à certains modèles. La clé brute n'est affichée qu'une seule fois. Jusqu'à 5 clés actives par compte — révoquez-en une ancienne pour en créer une nouvelle.

Codes d'erreur

Statut	Signification
400	URL de base / corps incorrects — vérifiez qu'il n'y a pas de double /v1 (p. ex. /v1/v1/messages)
401	Clé API invalide / mauvaise voie — clé payante ≠ clé bansos. Vérifiez l'URL de base : payant utilise /v1, bansos utilise /v1/claude
402	GeraiPoints insuffisants — veuillez recharger
403	Modèle non autorisé pour cette clé
404	Modèle inconnu — envoyez le NOM EXACT DU MODÈLE (p. ex. claude-sonnet-5), sans préfixe. Les noms comme gp/claude-sonnet-5 ou openai/... renverront 404
429	Trop de requêtes