跳转到主要内容

​
Responses API 概览

Responses API 是当前 Crazyrouter 上承载 GPT 新能力的主路由之一。 本文页只写入 2026-03-22 已在生产环境复核过的结论。
当前生产验证范围内，Claude 仅支持 POST /v1/messages 和 POST /v1/chat/completions，不支持 POST /v1/responses。Responses 相关页面默认只应按 GPT 路径理解。

​
当前推荐理解

  • 需要可观察的 reasoning 输出：优先用 /v1/responses
  • 需要 OpenAI 风格 Web Search：优先用 /v1/responses
  • 只做普通聊天或历史项目延续：可继续用 /v1/chat/completions

​
Responses API vs Chat Completions API

维度Responses APIChat Completions API
端点/v1/responses/v1/chat/completions
输入格式inputmessages
输出形态output[] item 列表choices[].message
GPT reasoning已复核 reasoning itemreasoning_effort 可用，但 reasoning_content 不稳定
OpenAI 风格 Web Search已复核 web_search_preview旧式 web_search 本轮未拿到稳定触发标志
流式事件事件类型更丰富传统 delta SSE

​
一个最小可用示例

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://crazyrouter.com/v1"
)

response = client.responses.create(
    model="gpt-5.4",
    input="Explain what a REST API is in one sentence."
)

print(response.output_text)
当前生产复核中，这类最小请求返回： 
{
  "object": "response",
  "output": [
    {
      "type": "message"
    }
  ]
}

​
什么时候优先选 Responses

  • 你要用 gpt-5.4 的 reasoning 摘要
  • 你要判断模型是否真的触发了 web_search_call
  • 你要消费更丰富的 SSE 事件
相关页：

​
什么时候继续用 Chat Completions

  • 你已有稳定的 Chat Completions 接入代码
  • 你只关心最终答案，不关心 reasoning item
  • 你在接 Claude、Gemini 等 OpenAI 兼容模型
两种 API 可以在同一项目中并存。当前更合理的做法通常不是“全量迁移”，而是把需要新能力的请求切到 /v1/responses。