Responses 介面與 Codex - NexusAPI

在 NexusAPI 中，/v1/responses 用於依Codex CLI 教學設定的自訂 Provider，以及目前 Key 的 /v1/models 回應中 supported_endpoint_types 包含 openai-response 的模型。

Responses 的適用範圍僅在模型的 supported_endpoint_types 包含 openai-response 時使用 /v1/responses。若出現 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，不使用本介面

最小驗證請求

只有在模型確認支援時，才用以下請求驗證連通性：

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。完整安裝、環境變數與驗證流程見Codex CLI 教學。

失敗時先檢查

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