Guide d'intégration du modèle de texte

Choisissez d'abord un protocole, puis copiez la configuration complète pour votre client.

Vous n'avez pas besoin de comprendre toutes les API. Choisissez Responses, Messages ou Chat — les protocoles actuellement pris en charge par AIReiter — puis copiez une configuration vérifiée à partir de la documentation officielle ou du code de ce projet.

Comparaison des prixLes modèles GPT-5.6 sont tarifés à 50 % des tarifs officiels de l’API

Prix officiel de l’API vs prix AIReiter

Tous les prix sont par 1M tokens. AIReiter est actuellement fixé à la moitié du tarif officiel de GPT-5.6, y compris l’entrée normale, la sortie, l’entrée mise en cache et les écritures de cache.

50%

Le prix AIReiter est la moitié du prix officiel de l’API pour les deux niveaux de contexte et tous les paliers de facturation du cache.

ModèleNiveau de contexteEntréeSortieLecture du cacheÉcriture du cache
GPT-5.6 LunaContexte < 272K
Officiel$1.00AIReiter$0.50
Officiel$6.00AIReiter$3.00
Officiel$0.10AIReiter$0.05
Officiel$1.25AIReiter$0.625
GPT-5.6 LunaContexte >= 272K
Officiel$2.00AIReiter$1.00
Officiel$9.00AIReiter$4.50
Officiel$0.20AIReiter$0.10
Officiel$2.50AIReiter$1.25
GPT-5.6 TerraContexte < 272K
Officiel$2.50AIReiter$1.25
Officiel$15.00AIReiter$7.50
Officiel$0.25AIReiter$0.125
Officiel$3.125AIReiter$1.5625
GPT-5.6 TerraContexte >= 272K
Officiel$5.00AIReiter$2.50
Officiel$22.50AIReiter$11.25
Officiel$0.50AIReiter$0.25
Officiel$6.25AIReiter$3.125
GPT-5.6 SolContexte < 272K
Officiel$5.00AIReiter$2.50
Officiel$30.00AIReiter$15.00
Officiel$0.50AIReiter$0.25
Officiel$6.25AIReiter$3.125
GPT-5.6 SolContexte >= 272K
Officiel$10.00AIReiter$5.00
Officiel$45.00AIReiter$22.50
Officiel$1.00AIReiter$0.50
Officiel$12.50AIReiter$6.25

Comment la facturation correspond à l’upstream

Le niveau est choisi en fonction de la longueur totale du contexte d’entrée. Les tokens mis en cache utilisent les prix de lecture du cache ou d’écriture du cache lorsque l’upstream signale cached_tokens ou cache_write_tokens ; sinon, les prix normaux d’entrée et de sortie s’appliquent.

Protocole Responses/api/v1/responses

Codex CLI

Les outils comme Codex CLI fonctionnent mieux avec Responses. Les points clés : base_url s'arrête à /api/v1 et wire_api est défini sur responses, avec la clé lue depuis la variable d'environnement indiquée par env_key.

Officiel OpenAIVoir le code source

Les champs model_providers / base_url / wire_api / env_key proviennent de la documentation officielle Advanced Configuration de Codex ; le fait que env_key doive pointer vers une variable d’environnement et que requires_openai_auth désactive env_key sont également des déclarations officielles. Notez que wire_api n’accepte responses que depuis Codex 0.59.

URL de base du client

https://aireiter.com/api/v1

Chemin ajouté par le client

/responses

URL finale de la requête

https://aireiter.com/api/v1/responses

Modèle d'exemple

gpt-5.6-luna

1

1. Écrivez config.toml

Emplacement du fichier : ~/.codex/config.toml. base_url doit s'arrêter à /api/v1 ; Codex appelle /responses via wire_api = "responses". env_key pointe vers le nom d'une variable d'environnement — ne mettez jamais la vraie clé dans le TOML, et n'ajoutez pas requires_openai_auth = true : avec cela, Codex ignore env_key et exige à la place une connexion officielle OpenAI.

Prêt à copier
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
2

2. Exportez la variable d'environnement de la clé API

Codex lit la clé depuis la variable d'environnement nommée par env_key au démarrage. Écrivez-la dans votre profil shell pour qu'elle soit conservée ; ne validez jamais la vraie clé dans un dépôt.

Prêt à copier
echo 'export AIREITER_API_KEY="sk-remplacez-par-votre-clé"' >> ~/.zshrc
source ~/.zshrc
3

3. Configuration en une seule fois sur macOS / Linux

Les deux étapes sont fusionnées en un seul bloc que vous pouvez coller et exécuter. Si vous avez déjà un config.toml, fusionnez-le à la main pour éviter d'écraser les autres fournisseurs.

Prêt à copier
mkdir -p "$HOME/.codex"

cat > "$HOME/.codex/config.toml" <<EOF
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
EOF

echo 'export AIREITER_API_KEY="sk-remplacez-par-votre-clé"' >> ~/.zshrc
source ~/.zshrc
4

4. Configuration en une seule fois sur Windows PowerShell

Les utilisateurs Windows copient ce bloc. setx écrit une variable d'environnement au niveau utilisateur ; ouvrez une nouvelle fenêtre de terminal pour qu'elle prenne effet.

Prêt à copier
$configDir = "$env:USERPROFILE\.codex"
New-Item -Path $configDir -ItemType Directory -Force | Out-Null

@"
model_provider = "aireiter"
model = "gpt-5.6-luna"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.aireiter]
name = "AIReiter"
base_url = "https://aireiter.com/api/v1"
wire_api = "responses"
env_key = "AIREITER_API_KEY"
"@ | Set-Content -Path "$configDir\config.toml"

setx AIREITER_API_KEY "sk-remplacez-par-votre-clé"
5

5. Vérification de connectivité

Demandez d'abord la liste des modèles. Lancez Codex seulement après avoir reçu une liste JSON — le dépannage devient beaucoup plus facile.

Prêt à copier
curl -sS -i "https://aireiter.com/api/v1/models" \
  -H "Authorization: Bearer $AIREITER_API_KEY" | head -n 20
6

6. Lancer Codex

Lancez-le après être entré dans le répertoire de votre projet. Une sortie en streaming signifie que l'intégration Responses fonctionne.

Prêt à copier
cd ~/your-project
codex
7

Aide-mémoire des codes de statut

Lorsque les utilisateurs signalent des erreurs, vérifiez d'abord le code de statut, puis base_url et la clé.

Prêt à copier
HTTP 200  La configuration est correcte, démarrez votre client
HTTP 401  La clé est incorrecte ou manquante, recopiez votre clé API
HTTP 403  La clé n'a pas accès à ce modèle, vérifiez le compte ou les autorisations du modèle
HTTP 404  URL incorrecte, vérifiez d'abord si base_url a un /api/v1 en trop ou manquant
HTML renvoyé  La requête a atteint l'interface du site web, base_url est incorrecte
HTTP 502/504  Incident de passerelle ou en amont, réessayez plus tard
Référence rapide des clients tiersTous les champs de configuration proviennent de la documentation officielle de chaque client

Quel point de terminaison pour CC Switch ou OpenClaw ?

Ce sont des clients qui transportent un protocole, pas des protocoles eux-mêmes : donnez aux outils de type Claude Code l'adresse de type Anthropic, et aux outils compatibles OpenAI /api/v1. Les guides complets, étape par étape, se trouvent sous le protocole correspondant ci-dessus.

CC Switch

Dans l'onglet Claude Code, définissez l'URL de base du fournisseur sur https://aireiter.com/api — guide sous « Messages protocol → CC Switch (GUI) ». Dans l'onglet Codex, utilisez https://aireiter.com/api/v1 — guide sous « Responses protocol → CC Switch (GUI) ».

OpenClaw

Avec api: "openai-completions", définissez baseUrl sur https://aireiter.com/api/v1 ; avec api: "anthropic-messages", utilisez https://aireiter.com/api. Guide étape par étape sous « Chat protocol → OpenClaw ».

Alignement du secteurComment les passerelles compatibles OpenAI écrivent baseURL

Ne confondez pas l'URL de base et l'URL finale.

Les passerelles de modèles textuels comme OpenRouter, Groq et Together ont toutes le SDK baseURL/base_url s'arrêtant à /v1, la méthode du SDK ajoutant /chat/completions. Cette page les sépare de la même manière : l'URL de base du client, le chemin ajouté par le client et l'URL finale de la requête sont affichés séparément.

Existe-t-il un count_tokens ?

Oui, à /api/v1/messages/count_tokens. Il ne fait que du comptage de tokens Anthropic — ce n'est pas un point de terminaison de génération.

Les sources sont-elles fiables ?

Les configurations prêtes à copier n'incluent que ce que la documentation officielle, les protocoles OpenAI/Anthropic ou le code de ce projet peuvent vérifier ; les clients tiers n'obtiennent que des notes de compatibilité.

Que devraient choisir les débutants ?

Codex → Responses ; Claude Code → Messages ; SDK OpenAI et clients génériques compatibles OpenAI → Chat ; si vous préférez ne pas modifier les fichiers de configuration, utilisez l'interface graphique CC Switch.