Codex über Responses mit Drittanbieter-Modellen verbinden

Kurz gefasst

Aktuelles Codex unterstützt für wire_api nur "responses". "chat" wurde entfernt und führt beim Start zu einem Konfigurationsfehler. KimiSeek bietet /v1/responses; die folgende Konfiguration verbindet Codex direkt damit.

Entscheidungstabelle in 30 Sekunden

Warum Codex standardmäßig responses nutzt

Codex sendet Anfragen an /responses und verarbeitet dessen Tool-Aufrufe und Streaming-Ereignisse. Chat Completions verwendet andere Anfrage- und Ereignisstrukturen; eine Änderung von wire_api macht es für aktuelles Codex nicht nutzbar. Die Fähigkeiten hängen auch vom Modell und Gateway ab. Ein erfolgreicher Endpunkttest bestätigt nicht sämtliche Tool-Funktionen.

Voraussetzungen

• Node.js 20 oder neuer
• Codex CLI: npm install -g @openai/codex
• ein KimiSeek API Key (beginnt mit ks-), im Dashboard erstellt

Schritt 1 · Konfigurationsdatei schreiben

Die Konfigurationsdatei liegt in ~/.codex/config.toml; legen Sie sie an, falls sie fehlt:

model = "deepseek-v4-pro-0813"
model_provider = "kimiseek"

[model_providers.kimiseek]
name = "KimiSeek"
base_url = "https://api.kimiseek.app/v1"
env_key = "KIMISEEK_API_KEY"
wire_api = "responses"

Drei Stellen, an denen man leicht hängen bleibt:

1. base_url muss /v1 enthalten. Codex hängt /responses direkt an base_url; fehlt /v1, landet die Anfrage auf https://api.kimiseek.app/responses und Sie bekommen einen 404.
2. env_key ist ein Variablenname, nicht der Key selbst. Hier steht der Variablenname KIMISEEK_API_KEY, der eigentliche Wert liegt in der Umgebungsvariable.
3. model muss eine id sein, die im Katalog wirklich existiert. Ein Tippfehler liefert model not found, und ein bereits abgeschaltetes Modell meldet denselben Fehler.

Schritt 2 · Umgebungsvariable setzen und starten

export KIMISEEK_API_KEY="ks-your-key"

codex

Wollen Sie das Modell vorübergehend wechseln, ändern Sie model in config.toml oder überschreiben es mit codex --model <id>.

Schritt 3 · Prüfen, ob der Key gültig ist

curl https://api.kimiseek.app/v1/models \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}"

Wenn die Antwort eine Modellliste enthält, sind Key und Netzwerk in Ordnung. Der Sinn dieses Schritts ist, „Authentifizierungsproblem“ und „Protokollproblem“ voneinander zu trennen – sonst können Sie bei einem 404 nicht sagen, ob der Key oder der Pfad falsch ist.

Schritt 4 · responses in 30 Sekunden testen

curl https://api.kimiseek.app/v1/responses \
  -H "Authorization: Bearer ${KIMISEEK_API_KEY:?Set KIMISEEK_API_KEY before running this command}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro-0813",
    "input": "Explain what a base URL is in one sentence.",
    "max_output_tokens": 256,
    "stream": false
  }'

• HTTP 200 mit einem JSON-Array output → die Responses-Route funktioniert; anschließend eine echte Aufgabe und Tool-Aufrufe testen.
• HTTP 404 → /v1 in base_url prüfen und im Antworttext zwischen fehlender Route und fehlendem Modell unterscheiden. Der Status allein reicht nicht.
• HTTP 401 → zu Schritt 3 zurückgehen und die Zugangsdaten prüfen.

Wenn das Gateway nur Chat Completions bietet

Bei wire_api = "responses" bleiben. Ein Gateway mit /v1/responses wählen oder eine kompatible Übersetzungsschicht einrichten. Nicht auf den entfernten Wert "chat" wechseln.

Häufige Fehler

Weitere Fehler auf Protokollebene stehen in der Fehlertabelle.

Kosten

Die Nutzung von Codex ist input-lastig: Jede Ausführung schickt den Kontext erneut. DeepSeek V4 Pro wird in zwei Stufen, peak und off-peak, in Renminbi pro Million tokens abgerechnet:

Der Unterschied zwischen peak und off-peak beträgt genau Faktor zwei. Große Refactoring-Läufe in die off-peak-Zeit zu legen, spart die Hälfte. Maßgeblich für die konkreten Modelle und aktuellen Preise ist die Preisseite, die direkt die Konfiguration des Modellkatalogs liest.

Geeignete Versionen und Prüfung

Konfiguration mit Codex CLI 0.154.0 am 2026-10-26 geprüft. Die unterstützten Protokolle stehen in der offiziellen Konfigurationsreferenz.