Responses
兼容 OpenAI Responses API(推理 / 代理 / 工具循环统一接口)。
POST https://api.wrouter.io/v1/responsesResponses 与 Chat Completions 都能完成对话任务,但 Responses 更适合:
- 推理模型(GPT-5、o3 等)的多步思考、工具使用循环
- Agentic 任务、流式中混入 tool result
- 服务端会话状态(
previous_response_id)
关键字段
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | ✓ | 推荐用支持 Responses 的模型,如 gpt-5、o3 |
input | string | array | 输入内容,可以是字符串或消息数组 | |
instructions | string | 类似 system prompt | |
max_output_tokens | integer | 最大输出 token(注意不是 max_tokens) | |
temperature | number | ||
top_p | number | ||
stream | boolean | SSE 流式 | |
tools | array | 内置工具(web_search、code_interpreter 等)或自定义函数 | |
tool_choice | string | object | ||
reasoning | object | {"effort":"low"|"medium"|"high"} | |
previous_response_id | string | 接续上一次响应,让服务端维护会话 | |
truncation | string | "auto" | "disabled" |
示例
python
from openai import OpenAI
client = OpenAI(api_key="sk-...", base_url="https://api.wrouter.io/v1")
r = client.responses.create(
model="gpt-5",
input="计算 2 的 32 次方,并给出推理过程。",
reasoning={"effort": "medium"},
)
print(r.output_text)与 Chat Completions 的取舍
| 场景 | 推荐 |
|---|---|
| 简单对话、最大兼容性 | Chat Completions |
| 推理模型 + 工具调用 | Responses |
| 跨厂商通用 | Chat Completions |
| 仅 OpenAI 高级模型 | Responses |
非 OpenAI 模型调用 /v1/responses 时,wrouter 会尽量转译,但部分高级特性可能缺失。