Responses

Responses 接口適合使用 OpenAI Responses 協議的客戶端、編碼代理和新一代應用框架。它通常用於需要統一輸入結構、工具調用、推理控制或更復雜響應結構的場景。

Endpoint

POST /v1/responses

完整地址：

https://www.routeapi.ai/v1/responses

請求示例

curl https://www.routeapi.ai/v1/responses \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "請說明 RouteAPI 的主要用途"
  }'

常見參數

字段	類型	必填	說明
model	string	是	模型 ID
input	string/array	是	輸入內容
instructions	string	否	系統級指令
stream	boolean	否	是否流式輸出
tools	array	否	工具定義
tool_choice	string/object	否	工具選擇策略
temperature	number	否	採樣溫度
max_output_tokens	number	否	最大輸出 token 數

與 Chat Completions 的區別

項目	Chat Completions	Responses
輸入結構	messages	input + instructions
兼容範圍	傳統 OpenAI SDK 兼容客戶端最多	新協議客戶端和編碼代理更常用
工具調用	支持，取決於所選模型	支持，通常表達能力更強
推薦場景	通用聊天、兼容接入	新項目、編碼代理、複雜任務

接入建議

• 如果客戶端明確要求 OpenAI Responses 協議，使用 /v1/responses。
• 如果客戶端只支持傳統 OpenAI Chat Completions，使用 /v1/chat/completions。
• 同一個模型是否支持 Responses 取決於 RouteAPI 模型配置和服務能力。