Responses API と Codex - NexusAPI 文档中心

/v1/responses は汎用の「新しいチャット API」ではありません。NexusAPI では主に Codex CLI ガイドで設定するカスタム Provider、またはモデル、Key グループ、チャネルが Responses プロトコル対応と明確に確認された場合に使用します。

最初にモデルとチャネルを確認してください現在の Anthropic 型 Claude チャネルでは /v1/responses を使わないでください。status_code=500, not implemented が出る場合は、Chat Completions を使うか、Claude Code をネイティブ Messages 設定にしてください。

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

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

場面	推奨方法
Codex CLI	Codex CLI ガイドの `wire_api = "responses"` Provider 設定を使用
Responses 対応が確認された別のアプリ	そのアプリの Responses クライアント/Schema を使い、最小リクエストから検証
一般的な OpenAI 互換テキストアプリ	Chat Completionsを使用。新しい API だからという理由だけで切り替えない
Anthropic 型 Claude	Messages または Chat Completions を使用し、このエンドポイントは使わない

最小検証リクエスト

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

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 として解析してはいけません。全フィールド、ストリーミングイベント、結果構造は Apifox API リファレンスまたはクライアントの公式 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/... ではないこと。
モデルが Responses 対応と確認されていること。Anthropic 型 Claude では別のプロトコルを使うこと。
Request ID、クライアントバージョン、エラー全文を保存し、自己確認に従うこと。