Responses

Responses 接口是 OpenAI 推出的新一代交互形态。相较于传统的 Chat Completions，该接口对工具调用、多模态输入与推理输出提供了更为统一的数据模型，常用于新版 coding agent（例如指定 wire_api = "responses" 的 Codex 客户端）与官方 SDK。

接口地址

POST https://console.anystarx.com/v1/responses

基础调用示例

Responses 接口使用 input 字段传递交互内容，支持传入单一文本字符串发起单轮请求：

curl https://console.anystarx.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "请用一段话概括 API 网关的核心职能。"
  }'

多轮消息请求结构

在需要传递上下文、系统指令或进行多轮对话时，可以将 input 设置为包含消息对象的数组：

{
  "model": "MODEL_ID",
  "input": [
    {
      "role": "system",
      "content": "你是一个严谨的软件架构文档助手。"
    },
    {
      "role": "user",
      "content": "请对比 Base URL 与具体 API Endpoint 在概念与使用上的差异。"
    }
  ]
}

适用场景与选择原则

在以下业务场景中建议优先选用 Responses 接口：

• 客户端工具在技术文档中明确声明需要对接 Responses API。
• 在 Codex 等代码助手的配置中指定使用 wire_api = "responses" 协议。
• 业务系统中使用了较新的 OpenAI 官方 SDK，并采用 client.responses.create() 方法组织调用。
• 需要利用新版协议对结构化工具调用和推理过程的规范化支持。

如果正在使用的第三方客户端、编辑器插件或开源项目仅支持标准的 Chat Completions 协议，则继续使用 /v1/chat/completions 接口即可，无需强行迁移。

Codex 工具集成说明

Codex 命令行工具默认通过本地配置文件读取服务商参数。在对接时，需要确保以下配置项设置完整：

• 服务提供商名称（Provider）。
• 接口基础地址（base_url = "https://console.anystarx.com/v1"）。
• 存储 API Key 的环境变量标识。
• 指定通信协议模式（如 wire_api = "responses" 或 wire_api = "chat"）。
• 目标模型的完整标识符（Model ID）。

详细的配置文件编写范例与调试步骤，可以查阅 Codex 接入指南。