文件

Responses API

更新於 2026-08-29

/v1/responses 是 OpenAI 的原生主要端點之一。官方建議新專案優先評估 Responses；若您的客戶端或框架預設使用 Chat Completions，請改用 OpenAI 相容呼叫。

Base URL 仍為 https://api.rokoapi.com/v1。

端點

POST /v1/responses

快速開始

curl https://api.rokoapi.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "請用一句話介紹你自己",
    "instructions": "你是一位回答精簡的助理"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

response = client.responses.create(
    model="gpt-4o",
    input="請用一句話介紹你自己",
    instructions="你是一位回答精簡的助理",
)
print(response.output_text)

取得文字優先使用 SDK 的 output_text；手動遍歷 output 時請注意首項可能是 reasoning 而非 message。

常用參數

參數	說明
`model`	已上線且支援 Responses 的模型 ID
`input`	字串或訊息陣列
`instructions`	系統指令（類似 system prompt）
`max_output_tokens`	最大輸出 token
`stream`	語意化事件串流
`tools` / `tool_choice`	函式與內建工具（視上游支援情況而定）

模型能力標識

模型頁會直接顯示管理後台設定的 Responses 能力。呼叫前請重點檢查以下標識：

標識	含義
`responses-native`	上游供應商原生支援 Responses 協定
`responses-compatible`	閘道會將請求轉換為其他上游協定；僅保證已宣告的能力
`structured-outputs`	支援 JSON Schema 結構化輸出
`previous-response-id`	支援使用 `previous_response_id` 延續回應
`conversation-state`	支援由上游管理的會話狀態
`responses-compact`	支援 `POST /v1/responses/compact`
`stored-responses`	支援 `store` 參數
`parallel-tool-calls`	支援平行工具呼叫
`max-tool-calls`	支援 `max_tool_calls` 限制

未顯示的能力不應由客戶端假定可用。轉換相容模型不會宣告依賴上游資源生命週期的能力，例如會話狀態、回應儲存和壓縮。

目前的轉換相容模型

模型	轉換方式	已相容能力
`deepseek-v4-flash`	Responses 與 DeepSeek Chat Completions 雙向轉換	文字、函式工具、工具結果、串流事件
`deepseek-v4-pro`	Responses 與 DeepSeek Chat Completions 雙向轉換	文字、函式工具、工具結果、串流事件
`glm-5.3`	Responses 與智譜 V4 Chat Completions 雙向轉換	文字、函式工具、工具結果、串流事件
`glm-5.3-flash`	Responses 與智譜 V4 Chat Completions 雙向轉換	文字、函式工具、工具結果、串流事件

這兩個模型採用無狀態相容轉換。請在客戶端保存完整對話及工具呼叫歷史，並在後續請求的 input 中重新提交。它們不支援 previous_response_id、conversation、compact 或回應儲存。

多輪對話

預設請在客戶端自行維護歷史記錄，將完整上下文放入 input 陣列。只有模型頁明確顯示 previous-response-id 或 conversation-state 時，才使用對應的有狀態參數。

串流輸出

Responses 串流為語意化事件（如 response.output_text.delta），與 Chat Completions 的 choices[0].delta 不同。設定 stream: true 後請依事件類型處理。

與 Chat Completions 對照

Chat Completions	Responses
`messages`	`input`
system 訊息	`instructions`
`max_tokens`	`max_output_tokens`
`choices[0].message.content`	`output_text`

注意

請先在模型頁或已上線模型文件確認目標模型是否支援 Responses
內建工具和背景任務等功能依賴上游；未在模型頁宣告的能力不屬於相容承諾

端點