Skip to main content
POST

簡介

Responses API 是 OpenAI 推出的新一代對話介面,專為推理模型(o 系列、GPT-5 系列)和進階功能設計。相比傳統的 Chat Completions API,Responses API 提供了更精細的推理控制、內建工具支援和多模態輸入能力。

適用情境

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

認證

Bearer Token,如 Bearer sk-xxxxxxxxxx

請求參數

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

基礎範例

進階功能

聯網搜尋(Web Search)

推理控制(Reasoning)

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

自訂函式呼叫

多模態輸入

對話延續

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

回應格式

對比:Responses API vs Chat Completions API