Skip to main content
POST

簡介

Responses API 是 OpenAI 推出的新一代對話介面,專為推理模型(o 系列、GPT-5 系列)和進階功能設計。相比傳統的 Chat Completions API,Responses API 提供了更精細的推理控制、內建工具支援和多模態輸入能力。
gpt-6.1-sol:函式呼叫和 reasoning.effort="max" 使用 Responses。Chat Completions 支援不帶工具的請求,reasoning_effort 可用值為 low、medium、high、xhigh。兩種介面均不支援 none 或 minimal,不要傳入 temperature、top_p 或 logprobs 相關欄位。詳見 GPT 6.1 Sol。

適用情境

  • 推理密集型任務:使用 o1、o3-mini、o4-mini、GPT-5 等推理模型
  • 需要聯網搜尋:內建 Web Search Preview 工具
  • 進階工具呼叫:支援 Function Call 和 Custom Tool Call
  • 多輪對話延續:透過 previous_response_id 實現對話歷史管理

認證

Bearer Token,如 Bearer sk-xxxxxxxxxx

請求參數

string
必填
模型識別碼,如 gpt-5.5、o4-mini、o3-mini
string | array
必填
輸入文本或 Responses 輸入條目陣列。
integer
最大輸出 token 數
boolean
是否啟用串流輸出
object
推理設定,如 {"effort": "high", "summary": "detailed"}
array
工具列表,支援 Web Search 和函式呼叫
string
上一條回應的 ID,用於延續對話

基礎範例

進階功能

聯網搜尋(Web Search)

推理控制(Reasoning)

說明: summary: "auto" 會自動產生推理摘要,適合快速取得結果。

自訂函式呼叫

Responses 的函式定義將 name、description、parameters、strict 與 type 放在同一層,不巢狀 function 物件。按型別處理 output 條目;執行函式後通過 function_call_output 和對應 call_id 回傳結果。無狀態請求需在後續 input 中保留完整 output 陣列,包括可能出現的 reasoning 條目;同時將 tool_choice 恢復為 “auto”,讓模型繼續生成回答。

多模態輸入

對話延續

透過 previous_response_id 實現多輪對話的上下文延續:

回應格式

對比:Responses API vs Chat Completions API