跳转到主要内容
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

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