Doubao 参数与协议差异
了解豆包系列模型在兼容协议下的参数差异与使用方式。
使用豆包模型时，根据本页调整所选协议的参数。完整请求和响应结构参阅 Chat Completions、Responses 和 Messages。
| 模型 | 适用范围 |
|---|
| doubao-seed-2-1-lite-260915、doubao-seed-evolving、doubao-seed-2-1-pro-260915 | 均支持 Chat、Responses、Messages；思考和工具规则合并说明，音频输入仅按 Lite 的支持范围列出 |
| doubao-seed-evolving | 持续升级的模型 ID，不与某个 Pro 日期版本视为同一版本；同一 Session 内保持调用配置稳定 |
| 字段 | 差异说明 |
|---|
thinking.type | 支持 enabled/disabled，默认开启思考 |
reasoning_effort | 默认 high；有效思考档位为 low/medium/high，minimal 关闭思考；兼容值 none 映射为 minimal，xhigh/max 映射为 high |
max_tokens | 默认 4096，限制最终回答，不包含思考；不是思考与正文的总预算 |
max_completion_tokens | 包含思考与最终回答，官方 Chat 字段范围为 1～65536；与 max_tokens 互斥，不直接将模型规格中的最大输出套作本字段上限 |
temperature、top_p | 范围分别为 [0,2]、[0,1]；不沿用旧 Seed 2.0 部分版本固定温度为 1 的规则 |
frequency_penalty、presence_penalty | Seed 2.0 及后续系列不支持；这属于能力限制，不是官方弃用标记 |
stop、logprobs | 官方对深度思考能力模型默认不支持，本页三款不在支持例外名单内 |
reasoning_content、encrypted_content | 默认返回思考摘要和加密原文；工具多轮须原样回传 encrypted_content，只回传摘要不能代替原文。两者同时回传时，加密原文优先 |
stream_options.chunk_include_usage | 默认 false；设为 true 时逐块返回累计用量，不能将每块的累计数再次相加 |
stream_options.include_usage | 控制结束前的请求总用量块；Lite 默认会返回请求用量，其他模型需显式开启。每块累计用量与最终总用量是两种设置 |
response_format | 支持 json_object/json_schema，结构化输出保留官方 Beta 定位；strict: true 约束官方已支持的 Schema 子集，不等于支持全部 JSON Schema 关键词 |
| 字段 | 差异说明 |
|---|
reasoning.effort | 使用 minimal/low/medium/high 及兼容映射值，默认与 Chat 相同；不放在请求体顶层 |
max_output_tokens | 包含思考与最终回答，不沿用 Chat 的回答预算口径或字段上限 |
text.format | JSON Schema 配置放在 text.format 内，通过 name/schema/strict 指定；不是 Qwen 的 text.format.json_schema 嵌套结构 |
store、previous_response_id | store 默认 true，可通过真实响应 ID 延续历史及原始思考；上一轮 instructions 不会自动继承 |
| 手动历史回传 | 不使用响应 ID 时，将实际返回的 reasoning 项、消息和工具调用项目完整回传，不用思考摘要替换加密内容 |
max_tool_calls | 范围 1～10，控制内置工具调用轮次，同一轮不限次数；属于尽力而为的限制，不是所有函数调用的硬性总次数上限 |
service_tier、store | 使用原厂 flex 模式时，store 只能为 false，不能同时依赖服务端存储响应 |
| 字段 | 差异说明 |
|---|
max_tokens | 官方列为可选，不照搬 Claude 的必填要求；示例仍显式设置输出预算 |
output_config.effort | 使用该字段控制思考深度，按模型的默认值和兼容映射处理；不把 Chat 的顶层字段移入请求 |
output_format | 顶层扩展，支持 text/json_object/json_schema；Schema 放在 output_format.schema，不是 Claude 的 output_config.format |
temperature、top_p | 范围分别为 [0,2]、[0,1]，包括合法的 top_p: 0 |
stop_sequences | 虽然通用字段接受字符串或数组，但官方注明深度思考能力模型默认不支持；不能仅凭字段存在就依赖停止效果 |
| 历史 thinking 块 | 完整回传实际返回的 thinking 与 signature，保持字段值和内容块顺序；不自行生成签名或以摘要重新构造历史 |
| 字段 | 差异说明 |
|---|
| 隐式缓存 | Chat／Responses 自动启用，无法关闭；本页模型相同前缀至少 1024 Token 才具备命中条件，不保证每次命中 |
prompt_cache_key | Chat／Responses 的缓存路由提示；同一会话保持稳定取值，不能将同 Key 理解为固定实例或必然命中 |
Responses caching | 原厂显式缓存扩展，type: "enabled" 开启；prefix: true 只写前缀缓存、不生成回复，false 正常生成并写缓存 |
caching 组合限制 | 不可与 instructions 或非 Function 类型的 tools 一起使用；不要套用其他厂商的 TTL 或 Session Header |
| 缓存用量 | Chat 查看 usage.prompt_tokens_details.cached_tokens，Responses 查看 usage.input_tokens_details.cached_tokens；Messages 查看实际返回的 usage.cache_read_input_tokens、usage.cache_creation_input_tokens |
将 MODEL_ID 替换为平台提供的完整模型 ID，API Key 使用自己的值。
curl 'https://api.agtcloud.cn/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "用三点说明如何排查接口超时"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096
}'