Doubao 參數與協定差異
了解 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.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "用三點說明如何排查 API 逾時"}],
"reasoning_effort": "low",
"max_completion_tokens": 4096
}'