Skip to main content
POST
Responses:Seed 2.1 Turbo 文本生成(原生多轮/显式缓存)
右側 Playground 可直接除錯:在 AuthorizationBearer sk-your-api-key,填好 input 後傳送。響應 output 陣列中 type: "reasoning" 是思考摘要,type: "message" 才是正文。
多輪對話把上一輪響應的 idresp_ 開頭)作為下一輪 previous_response_id 傳入即可,無需重發歷史訊息。顯式快取、思考控制等機制詳見 Seed 2.1 Turbo 概覽
  • max_output_tokens 太小會被思考吃滿,返回 status: "incomplete"正文為空,建議 1500 起步
  • 顯式快取 caching: {"type": "enabled"} 必須配合 previous_response_id 鏈式呼叫才會命中;只重複相同字首不命中(連隱式字首快取也會失效)

引數說明速查

響應要點

  • statusincomplete 時檢查 incomplete_details.reason(多為 length,即配額被思考吃滿)
  • 思考消耗看 usage.output_tokens_details.reasoning_tokens
  • 快取命中看 usage.input_tokens_details.cached_tokens(鏈式第 2 輪實測可整輪命中,延遲約減半)
  • 響應 caching 欄位回顯本次實際生效的快取模式

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
model
enum<string>
預設值:dola-seed-2-1-turbo-260628
必填

模型 ID,固定 dola-seed-2-1-turbo-260628

可用選項:
dola-seed-2-1-turbo-260628
input
string
必填

输入内容。可为字符串,也可为消息数组([{role, content}, ...],含 function_call_output 等 item)

範例:

"用一句话介绍你自己"

max_output_tokens
integer
預設值:1500

最大输出 tokens(含思考)。太小会 incomplete 且正文为空,建议 1500+

reasoning
object

思考深度控制。实测 effort low 约 371、high 约 1317 reasoning tokens

previous_response_id
string

上一轮响应 id(resp_ 开头),实现原生多轮;配合 caching.enabled 可命中显式缓存

caching
object

显式缓存开关。enabled 需配合 previous_response_id 链式调用才会命中

store
boolean

是否存储本轮响应供后续 previous_response_id 引用

stream
boolean
預設值:false

是否流式输出(response.created → response.output_text.delta → response.completed 事件流)

text
object

结构化输出。支持 {"format": {"type": "json_schema", name, strict, schema}}

tools
object[]

Function Call 工具列表(Responses 扁平格式:{type, name, description, parameters})

回應

生成成功。output 数组含 reasoning item 与 message item

id
string

响应 ID(resp_ 开头),可作为下一轮 previous_response_id

status
string

completed / incomplete(配额被思考吃满时为 incomplete)

output
object[]

输出 item 数组:reasoning(思考摘要)、message(正文)、function_call 等

usage
object

用量。output_tokens_details.reasoning_tokens 为思考消耗;input_tokens_details.cached_tokens 为缓存命中量

caching
object

本次请求实际生效的缓存模式