Skip to main content
/v1/responses 不是通用的“更高级聊天接口”。在 NexusAPI 中，它主要用于按Codex CLI 教程配置的自定义 Provider，或模型、分组和渠道已明确支持 Responses 协议的场景。
先确认模型与渠道当前 Anthropic 类型 Claude 渠道不要使用 /v1/responses。这类调用出现 status_code=500, not implemented 时，应改用 Chat Completions，或让 Claude Code 使用原生 Messages 配置。

​
端点和适用范围

​
最小验证请求

只有在模型和渠道确认支持时，才可用如下请求验证连通性：
input 与 Chat Completions 的 messages 不是同一字段，响应也不应按 choices[0].message 解析。完整的 Responses 字段、事件流和结果结构请看 Apifox 接口参考或所用客户端的官方 Schema。

​
Codex CLI 配置要点

Codex 会根据 Provider 的 wire_api 决定请求格式。NexusAPI 的配置应保持以下关键项一致：
Key 放在 NEXUSAPI_API_KEY 环境变量中，不要写入 config.toml 或 auth.json。完整的安装、各系统环境变量和验证流程见Codex CLI 教程。

​
失败时先看什么

  1. Key 所属分组是否包含该模型，模型 ID 是否与模型广场一致。
  2. 客户端是否真的发往 /v1/responses，而不是重复拼出 /v1/v1/...。
  3. 所选模型是否是当前明确支持 Responses 的类型；若是 Anthropic 类型 Claude，改用正确协议。
  4. 保留 Request ID、客户端版本和完整错误原文，再按问题自查处理。