Leitfaden zur Textmodell-Integration

Wähle zuerst ein Protokoll und kopiere dann die vollständige Konfiguration für deinen Client.

Du musst nicht jede API verstehen. Wähle Responses, Messages oder Chat — die Protokolle, die AIReiter derzeit unterstützt — und kopiere dann eine Konfiguration, die anhand der offiziellen Dokumentation oder des Codes dieses Projekts überprüft wurde.

PreisvergleichGPT-5.6-Modelle sind mit 50 % der offiziellen API-Tarife bepreist

Offizieller API-Preis vs. AIReiter-Preis

Alle Preise gelten pro 1 Mio. Tokens. AIReiter ist derzeit auf die Hälfte des offiziellen GPT-5.6-Tarifs eingestellt, einschließlich normalem Input, Output, gecachtem Input und Cache-Schreibvorgängen.

50%

Der AIReiter-Preis beträgt die Hälfte des offiziellen API-Preises über beide Kontextstufen und alle Cache-Abrechnungsblöcke hinweg.

ModellKontextstufeInputOutputCache-LesenCache-Schreiben
GPT-5.6 LunaKontext < 272K
Offiziell$1.00AIReiter$0.50
Offiziell$6.00AIReiter$3.00
Offiziell$0.10AIReiter$0.05
Offiziell$1.25AIReiter$0.625
GPT-5.6 LunaKontext >= 272K
Offiziell$2.00AIReiter$1.00
Offiziell$9.00AIReiter$4.50
Offiziell$0.20AIReiter$0.10
Offiziell$2.50AIReiter$1.25
GPT-5.6 TerraKontext < 272K
Offiziell$2.50AIReiter$1.25
Offiziell$15.00AIReiter$7.50
Offiziell$0.25AIReiter$0.125
Offiziell$3.125AIReiter$1.5625
GPT-5.6 TerraKontext >= 272K
Offiziell$5.00AIReiter$2.50
Offiziell$22.50AIReiter$11.25
Offiziell$0.50AIReiter$0.25
Offiziell$6.25AIReiter$3.125
GPT-5.6 SolKontext < 272K
Offiziell$5.00AIReiter$2.50
Offiziell$30.00AIReiter$15.00
Offiziell$0.50AIReiter$0.25
Offiziell$6.25AIReiter$3.125
GPT-5.6 SolKontext >= 272K
Offiziell$10.00AIReiter$5.00
Offiziell$45.00AIReiter$22.50
Offiziell$1.00AIReiter$0.50
Offiziell$12.50AIReiter$6.25

Wie die Abrechnung mit dem Upstream übereinstimmt

Die Stufe wird anhand der vollständigen Eingabekontextlänge gewählt. Zwischengespeicherte Tokens verwenden Cache-Lese- oder Cache-Schreibpreise, wenn der Upstream cached_tokens oder cache_write_tokens meldet; andernfalls gelten die normalen Input- und Output-Preise.

Responses-Protokoll/api/v1/responses

Codex CLI

Tools wie Codex CLI funktionieren am besten über Responses. Die wichtigsten Punkte: base_url endet bei /api/v1 und wire_api ist auf responses gesetzt, wobei der Schlüssel aus der Umgebungsvariable gelesen wird, auf die env_key verweist.

Offiziell von OpenAIQuelle anzeigen

Die Felder model_providers / base_url / wire_api / env_key stammen aus Codex' offizieller Doku zur Advanced Configuration; dass env_key auf eine Umgebungsvariable verweisen muss und dass requires_openai_auth env_key deaktiviert, sind ebenfalls offizielle Aussagen. Beachten Sie, dass wire_api seit Codex 0.59 nur responses akzeptiert.

Client Base URL

https://aireiter.com/api/v1

Vom Client angehängter Pfad

/responses

Endgültige Request-URL

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

Beispielmodell

gpt-5.6-luna

1

1. config.toml schreiben

Dateispeicherort: ~/.codex/config.toml. base_url muss bei /api/v1 enden; Codex ruft /responses gemäß wire_api = "responses" auf. env_key verweist auf einen Namen einer Umgebungsvariable — den echten Schlüssel niemals in die TOML eintragen und requires_openai_auth = true nicht hinzufügen: Damit ignoriert Codex env_key und verlangt stattdessen eine offizielle OpenAI-Anmeldung.

Kopierbereit
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. API-Schlüssel-Umgebungsvariable exportieren

Codex liest den Schlüssel beim Start aus der durch env_key benannten Umgebungsvariable. Schreibe ihn in dein Shell-Profil, damit er erhalten bleibt; committe den echten Schlüssel niemals in ein Repository.

Kopierbereit
echo 'export AIREITER_API_KEY="sk-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
3

3. Einmalige Einrichtung für macOS / Linux

Beide Schritte zu einem Block zusammengeführt, den du einfügen und ausführen kannst. Wenn du bereits eine config.toml hast, füge sie manuell zusammen, um ein Überschreiben anderer Anbieter zu vermeiden.

Kopierbereit
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-replace-with-your-key"' >> ~/.zshrc
source ~/.zshrc
4

4. Einmalige Einrichtung für Windows PowerShell

Windows-Benutzer kopieren diesen Block. setx schreibt eine Umgebungsvariable auf Benutzerebene; öffne ein neues Terminalfenster, damit sie wirksam wird.

Kopierbereit
$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-replace-with-your-key"
5

5. Selbstprüfung der Verbindung

Fordere zuerst die Modellliste an. Starte Codex erst, nachdem du eine JSON-Liste zurückbekommen hast — die Fehlersuche wird dadurch viel einfacher.

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

6. Codex starten

Starte erst nach dem Wechsel in dein Projektverzeichnis. Streaming-Ausgabe bedeutet, dass die Responses-Integration funktioniert.

Kopierbereit
cd ~/your-project
codex
7

Spickzettel für Statuscodes

Wenn Nutzer Fehler melden, prüfe zuerst den Statuscode, dann base_url und den Schlüssel.

Kopierbereit
HTTP 200  Konfiguration ist korrekt, starte deinen Client
HTTP 401  Schlüssel ist falsch oder fehlt, kopiere deinen API-Schlüssel erneut
HTTP 403  Der Schlüssel hat keinen Zugriff auf dieses Modell, prüfe Konto- oder Modellberechtigungen
HTTP 404  Falsche URL, prüfe zuerst, ob base_url ein zusätzliches oder fehlendes /api/v1 hat
HTML zurückgegeben  Die Anfrage hat das Website-Frontend erreicht, base_url ist falsch
HTTP 502/504  Gateway- oder Upstream-Fehler, später erneut versuchen
Schnellreferenz für Drittanbieter-ClientsAlle Konfigurationsfelder stammen aus der offiziellen Dokumentation des jeweiligen Clients

Welcher Endpunkt für CC Switch oder OpenClaw?

Das sind Clients, die ein Protokoll tragen, aber nicht selbst Protokolle sind: Gib Claude-Code-ähnlichen Tools die Anthropic-artige Adresse und OpenAI-kompatiblen Tools /api/v1. Vollständige Schritt-für-Schritt-Anleitungen findest du unter dem passenden Protokoll oben.

CC Switch

Im Claude Code-Tab setze die Provider-Base-URL auf https://aireiter.com/api — Anleitung unter "Messages protocol → CC Switch (GUI)". Im Codex-Tab verwende https://aireiter.com/api/v1 — Anleitung unter "Responses protocol → CC Switch (GUI)".

OpenClaw

Bei api: "openai-completions" setze baseUrl auf https://aireiter.com/api/v1; bei api: "anthropic-messages" verwende https://aireiter.com/api. Schritt-für-Schritt-Anleitung unter "Chat protocol → OpenClaw".

BranchenübereinstimmungWie OpenAI-kompatible Gateways baseURL schreiben

Verwechsele die Basis-URL nicht mit der endgültigen URL.

Textmodell-Gateways wie OpenRouter, Groq und Together lassen die SDK baseURL/base_url alle bei /v1 enden, wobei die SDK-Methode /chat/completions anhängt. Diese Seite trennt sie genauso: Client-Basis-URL, vom Client angehängter Pfad und endgültige Request-URL werden separat angezeigt.

Gibt es ein count_tokens?

Ja, unter /api/v1/messages/count_tokens. Es dient nur zur Anthropic-Tokenzählung — es ist kein Generierungsendpunkt.

Sind die Quellen zuverlässig?

Die kopierfertigen Konfigurationen enthalten nur das, was offizielle Dokus, die OpenAI/Anthropic-Protokolle oder der Code dieses Projekts verifizieren können; Drittanbieter-Clients erhalten nur Kompatibilitätsnotizen.

Welche sollten Anfänger wählen?

Codex → Responses; Claude Code → Messages; OpenAI SDK und generische OpenAI-kompatible Clients → Chat; wenn du Konfigurationsdateien lieber nicht bearbeitest, nutze die CC Switch GUI.