Responses
採用 Responses 協議格式 — 面向推理、代理與工具迴圈的統一介面。
POST https://wrouter.ai/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://wrouter.ai/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 |
| 原生支援 Responses 協議的旗艦推理模型 | Responses |
對不原生支援 Responses 協議的模型,WRouter 會盡量轉譯,但部分高階特性可能缺失。