メインコンテンツまでスキップ

Codex

Codex をゲートウェイの Responses API に向けます。このページは設定の概略です。このレーンのクライアント確認レベルは、モックの Codex CLI によるエンドツーエンド実行です(TestResponses_CodexCLI_MockE2E)。ライブの Codex バイナリは、ゲートウェイに対して実行されていません(互換性マトリクス では not verified)。これはオーナーのスタンドのままです。

設定​

~/.codex/config.toml:

[model_providers.yabanin]
name = "Yabanin"
base_url = "https://gateway.example.internal/v1"
env_key = "YABANIN_API_KEY"
wire_api = "responses"

キーはファイルではなく、環境に置きます。

export YABANIN_API_KEY='yb_…'

エンドポイント​

POST /v1/responses です。解決されたプロバイダが openai で、組織にツール拒否の方針がない場合、ゲートウェイはボディを変えずに転送します。それ以外の場合は、呼び出しを chat completions に変換します。

プロバイダキーの持ち込み(BYOK)​

組織の管理者が、管理コンソールで上流プロバイダのキーを一度追加します(設定 → プロバイダキー。BYOK を参照)。モデルが組織の資格情報を経由して経路を通る場合、クライアント側の変更は不要です。上記の yb_… のゲートウェイキーをそのまま使い、ゲートウェイが組織のキーで上流を認証します。

制限​

  • ステートレスなセッションモデル(R046 D1)です。ゲートウェイは、どの経路でもレスポンスの状態を保持しません。previous_response_id は、すべての経路で 400 により拒否されます。サポートされるフローは、Codex の全履歴の再送(store=false)です。
  • 変換で表現できないフィールド(reasoning.effort、verbosity、未サポートのツール、…)は破棄され、X-Yabanin-Unsupported レスポンスヘッダで通知されます。黙って捨てることはありません。
  • ストリームの中断(R046-03)です。上流のストリームがレスポンスの途中で切れた場合、ゲートウェイは response.failed の SSE イベントを追加し、request.failed を記録し、中断したストリームには課金しません。クライアントがハングアップした場合、消費済みのプレフィックスは課金されたままです(request.completed)。終端イベントの後の正常終了は、request.completed のままです。
  • 認証面は、API キーの bearer(yb_…)だけです。Codex の ChatGPT-OAuth ログイン(codex login)はサポートされません。上に示したとおり env_key を設定します。
  • クライアント確認です。実機の codex exec(codex-cli 0.162.1)を、モックの上流に対してゲートウェイで確認済みです(2026-10-18、R046-05)。有料の上流によるライブ実行は、別のオーナーのスタンドです。

確認​

curl -sS -o /dev/null -w '%{http_code}\n' \
-H "Authorization: Bearer $YABANIN_API_KEY" \
https://gateway.example.internal/v1/models

200 は、ゲートウェイがキーを受理したことを意味します。Codex は起動しません。