Responses API と Codex - NexusAPI

NexusAPI では、/v1/responses は Codex CLI ガイドで設定するカスタム Provider、または現在の Key の /v1/models 応答で supported_endpoint_types に openai-response を含むモデルに使用します。

Responses を使用する条件/v1/responses は supported_endpoint_types に openai-response を含む場合だけ使用します。status_code=500, not implemented が出る場合は、そのモデルで示されたプロトコルを使用してください。通常は一時的な再試行対象ではありません。

エンドポイントと適用範囲

POST https://nexusapi.link/v1/responses

場面	推奨方法
Codex CLI	Codex CLI ガイドの `wire_api = "responses"` Provider 設定を使用
`supported_endpoint_types` に `openai-response` を含むモデルを使う別のアプリ	そのアプリの Responses クライアント/Schema を使い、最小リクエストから検証
一般的な OpenAI 互換テキストアプリ	Chat Completionsを優先
`openai-response` を含まないモデル	`supported_endpoint_types` に示された Chat Completions または Messages を使用し、この endpoint は使わない

最小検証リクエスト

モデルの対応を確認した場合のみ、次で接続を確認します。

curl 'https://nexusapi.link/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "YOUR_RESPONSES_MODEL_ID",
    "input": "接続成功とだけ返答してください"
  }'

input は Chat Completions の messages と別のフィールドで、レスポンスを choices[0].message として解析してはいけません。全フィールド、ストリーミングイベント、結果構造はクライアントの公式 Schema を参照してください。

Codex CLI 設定の要点

model_provider = "nexusapi"
model = "YOUR_MODEL_ID"

[model_providers.nexusapi]
base_url = "https://nexusapi.link/v1"
env_key = "NEXUSAPI_API_KEY"
wire_api = "responses"

Key は NEXUSAPI_API_KEY 環境変数に置き、config.toml や auth.json に書かないでください。インストール、OS 別環境変数、検証はCodex CLI ガイドを参照してください。

最初に確認すること

Key グループにモデルがあり、モデル ID がモデルマーケットプレイスと完全に一致すること。
クライアントが /v1/responses を送っており、/v1/v1/... ではないこと。
モデルの supported_endpoint_types に openai-response が含まれること。含まれない場合は、示された対応プロトコルを使うこと。
Request ID、クライアントバージョン、エラー全文を保存し、自己確認に従うこと。