> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Responses API 概览

> 基于生产环境复核，理解 Crazyrouter 中 Responses API 与 Chat Completions 的取舍

> 更新日期：2026-06-06

# Responses API 概览

Responses API 是当前 Crazyrouter 上承载 GPT 新能力的主路由之一。

本文页只写入 `2026-03-22` 已在生产环境复核过的结论。

<Note>
  当前生产验证范围内，Claude 仅支持 `POST /v1/messages` 和 `POST /v1/chat/completions`，不支持 `POST /v1/responses`。Responses 相关页面默认只应按 GPT 路径理解。
</Note>

## 当前推荐理解

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

## Responses API vs Chat Completions API

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

***

## 一个最小可用示例

```python Python theme={null}
from openai import OpenAI

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

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

print(response.output_text)
```

当前生产复核中，这类最小请求返回：

```json theme={null}
{
  "object": "response",
  "output": [
    {
      "type": "message"
    }
  ]
}
```

***

## 什么时候优先选 Responses

* 你要用 `gpt-5.5` 的 reasoning 摘要
* 你要判断模型是否真的触发了 `web_search_call`
* 你要消费更丰富的 SSE 事件

相关页：

* [GPT-5 思考模式](/chat/responses/gpt5-thinking)
* [Responses Web 搜索](/chat/responses/web-search)
* [Responses Function Calling](/chat/responses/function-calling)

***

## 什么时候继续用 Chat Completions

* 你已有稳定的 Chat Completions 接入代码
* 你只关心最终答案，不关心 `reasoning` item
* 你在接 Claude、Gemini 等 OpenAI 兼容模型

<Note>
  两种 API 可以在同一项目中并存。当前更合理的做法通常不是“全量迁移”，而是把需要新能力的请求切到 `/v1/responses`。
</Note>