Skip to content

Responses

採用 Responses 協議格式 — 面向推理、代理與工具迴圈的統一介面。

POST https://wrouter.ai/v1/responses

Responses 與 Chat Completions 都能完成對話任務,但 Responses 更適合:

  • 推理模型(GPT-5、o3 等)的多步思考、工具使用迴圈
  • Agentic 任務、流式中混入 tool result
  • 服務端會話狀態(previous_response_id

關鍵欄位

引數型別必填說明
modelstring推薦用支援 Responses 的模型,如 gpt-5o3
inputstring | array輸入內容,可以是字串或訊息陣列
instructionsstring類似 system prompt
max_output_tokensinteger最大輸出 token(注意不是 max_tokens
temperaturenumber
top_pnumber
streambooleanSSE 流式
toolsarray內建工具(web_searchcode_interpreter 等)或自定義函式
tool_choicestring | object
reasoningobject{"effort":"low"|"medium"|"high"}
previous_response_idstring接續上一次響應,讓服務端維護會話
truncationstring"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 會盡量轉譯,但部分高階特性可能缺失。