Responses 介面與 Codex - NexusAPI 文档中心

/v1/responses 並不是通用的「更進階聊天介面」。在 NexusAPI 中，它主要用於依Codex CLI 教學設定的自訂 Provider，或模型、群組與渠道已明確支援 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，不要為了「新介面」強行切換
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。完整安裝、環境變數與驗證流程見Codex CLI 教學。

失敗時先檢查

Key 群組是否包含該模型，模型 ID 是否與模型廣場一致。
用戶端是否真的請求 /v1/responses，而非重複拼出 /v1/v1/...。
模型是否明確支援 Responses；若是 Anthropic 類 Claude，請改用正確協定。
保留 Request ID、用戶端版本與完整錯誤原文，再依問題自查處理。