火山方舟
火山方舟
文档指南
请输入
- 文档首页
火山方舟调用进阶使用深度思考
复制全文
下载 pdf深度思考
文档反馈
问问助手深度思考指模型在回答前，对问题进行分析及多步骤规划，再尝试解决问题。擅长处理编程、科学推理、智能体工作流等复杂及抽象场景。启用深度思考后，会在指定字段返回思维链内容，可基此观察和使用模型推导内容。
说明
快速开始
输入 | 思维链 | 回答 |
| | |
模型及 API
支持的 API：
- Responses API：新推出的 API，简洁上下文管理，增强工具调用能力，缓存能力降低成本，新业务及用户推荐。
- Chat API：使用广泛的 API，存量业务迁移成本低。
基础使用
多轮对话
组合使用系统消息、模型消息以及用户消息，可以实现多轮对话。当需要持续在一个主题内对话，可以将历史轮次的对话记录输入给模型。
在构建多轮对话的上下文时：保留历史对话的 reasoning_content 字段，由模型自行判断是否将该字段加入到推理输入中。
流式输出
随着大模型输出，动态输出内容，无需等待模型推理完毕，即可看到中间输出过程内容。
预览 | 优势 |
Play
00:00
Fullscreen
Cssfullscreen
Click and hold to drag
|
|
通过配置 stream 为 true，来启用流式输出。
开启/关闭深度思考
提供 thinking 字段控制是否关闭深度思考能力，实现“复杂任务深度推理，简单任务高效响应”的精细控制，获得成本、效率收益。
- 取值说明：
- enabled：强制开启，强制开启深度思考能力。
- disabled：强制关闭深度思考能力。
- 示例代码：
}></RenderMd></Tabs.TabPane> <Tabs.TabPane title="Python" key="BTvghsyVGG"><RenderMd content={```Python
import os
# Install SDK: python -m pip install --upgrade arkruntime
from arkruntime import Ark
- 支持模型：
- doubao-seed-evolving：支持 enabled（默认）、disabled。
- doubao-seed-2-1-pro-260915：支持 enabled（默认）、disabled。
- doubao-seed-2-1-lite-260915：支持 enabled（默认）、disabled。
- doubao-seed-2-1-pro-260628：支持 enabled（默认）、disabled。
- doubao-seed-2-1-turbo-260628：支持 enabled（默认）、disabled。
- doubao-seed-2-0-lite-260428：支持 enabled（默认）、disabled。
- doubao-seed-2-0-mini-260428：支持 enabled（默认）、disabled。
- doubao-seed-2-0-pro-260215：支持 enabled（默认）、disabled。
- doubao-seed-2-0-lite-260215：支持 enabled（默认）、disabled。
- doubao-seed-2-0-mini-260215：支持 enabled（默认）、disabled。
- doubao-seed-2-0-code-preview-260215：支持 enabled（默认）、disabled。
- glm-5-3-flash-260828：支持 enabled（默认）。(始终启用思考，不再支持禁用思考。)
- glm-5-2-260617：支持 enabled（默认）、disabled。
- doubao-seed-character-260628：支持 enabled（默认）、disabled。
- deepseek-v4-1-flash-261017：支持 enabled（默认）、disabled。
- deepseek-v4-1-flash-260910：支持 enabled（默认）、disabled。
- deepseek-v4-1-flash-economy-261017：支持 enabled（默认）、disabled。
- deepseek-v4-pro-ga-260813：支持 enabled（默认）、disabled。
- deepseek-v4-flash-ga-260731：支持 enabled（默认）、disabled。
- deepseek-v4-pro-260425：支持 enabled（默认）、disabled。
- 更多说明
- Responses API 使用说明请参见控制深度思考。
- 深度思考会影响续写模式，详细信息请参见续写模式。
设置最大输出长度
模型输出内容由思维链（Chain of Thought, COT） 和最终回答（Answer） 两部分组成。合理控制模型输出长度，平衡效果、速度、成本与稳定性。
调节思考长度
提供字段 reasoning_effort（Chat API）、reasoning.effort（Responses API）调节思维链长度，平衡不同场景对效果、时延、成本的需求。取值如下：
- none：关闭思考。
- minimal：关闭思考，直接回答。
- low：轻量思考，侧重快速响应。
- medium：均衡模式，兼顾速度与深度。
- high：深度分析，处理复杂问题。
- xhigh：更高强度思考。
- max：最高强度思考，适配高难度推理任务。
下表展示支持调节思考长度的模型，以及各模型对 reasoning_effort（Chat API）、reasoning.effort（Responses API）的默认取值与兼容映射规则。所有支持该字段的模型均接受全部 7 档取值，部分取值将按表中规则自动映射至等效档位。
支持模型 | 默认取值 | 兼容映射 |
| high |
|
| medium |
|
glm-5-3-flash-260828 | max |
|
glm-5-2-260617 | high |
|
| high |
|
始终开启思考，不使用 thinking 参数。 | max |
|
| high |
|
* deepseek-v4-pro-260425 | high | * 传入 minimal：将关闭思考 |
回传思考内容
doubao-seed-1.8 之前的模型在工具调用场景中开启深度思考后，会直接丢弃思维链内容。doubao-seed-1.8 及部分模型为给出更详尽准确的回答，将不会直接丢弃思维链内容，思维链内容可能参与后续轮次推理，输入 tokens 会增加，具体参见工作原理。
说明
推荐在 Responses API 中使用 previous_response_id，平台自动保存历史对话的上下文，并在多轮交互中回传给推理服务。
回传思考内容加密原文
部分模型默认会开启 thinking summary 能力，不会输出模型原始的思考内容，会返回模型思考内容摘要（choices.message.reasoning_content）、思考内容加密原文（choices.message.encrypted_content）。在多轮工具调用场景（如 agent 场景），必须原样回传思考内容加密原文。
说明
默认开启 thinking summary 能力后，可能会有较高的包间延迟，请调大请求超时时间（timeout），并做好兼容适配。
支持模型：
- doubao-seed-evolving
- doubao-seed-2-1-pro-260915
- doubao-seed-2-1-lite-260915
- doubao-seed-2-1-pro-260628
- doubao-seed-2-1-turbo-260628
- doubao-seed-2-0-lite-260428
字段说明：
- reasoning_effort：仅作用于模型的原始思考内容，不适用于思考摘要。
- usage.completion_tokens_details.reasoning_tokens：为原始思考内容的 tokens，计费仍然按原始思考内容 token 计算。
回传注意事项：
- 回传 encrypted_content、reasoning_content 字段： encrypted_content 字段优先级高，会忽略 reasoning_content 中的内容。其中 encrypted_content 内容必须为有效内容，如果被篡改则无法还原。
- 仅回传 reasoning_content 字段：使用思考内容摘要参与模型推理。在多轮工具调用场景（如 agent 场景），如果没有回传 encrypted_content 字段，将导致模型推理效果下降。
- 未回传思考内容相关字段：不会报错。
回传思考内容加密原文示例：
以下是在工具调用场景，回传思考内容加密原文的示例。其中使用 Responses API 推荐使用 previous_response_id 自动获取原始思考内容并回传给模型参与推理。
回传原始思考内容
部分模型开启深度思考后，默认输出模型原始的思考内容。以下是在工具调用场景，回传原始思考内容的示例。
使用说明
工作原理
- 多轮对话场景
- 流程图说明
- 在每一轮对话过程中，深度思考模型会输出思维链内容（COT）和最终回答（Answer）。
- 在下一轮对话中，之前输出的思维链内容不会被拼接到上下文中。
思维链内容展现的是模型处理问题的过程，包括将问题拆分为多个问题进行处理，生成多种回复综合得出更好回答等过程。
- 工具调用场景
- 工具调用场景中开启深度思考后，为给出更详尽准确的回答，将不会直接丢弃思维链内容，历史轮次的思维链内容按需（模型自主判断）参与推理。在整个请求过程中，用户回传完整上下文即可，由服务端自行判断，是否保留思维链内容。未输入给模型的思维链内容，不会计算 token 用量。代码示例参见回传思考内容。
- 流程图说明
- 回答问题 1 时（请求 1.1 - 1.2），模型进行多次思考 + 工具调用后给出答案，方舟会输入完整上下文包括思维链内容给模型处理。
- 开始回答问题 2 时（请求 2.1），方舟会自行判断并删除之前上下文中的思维链，输入给模型。
减少请求超时失败
深度思考模型使用思维链输出内容，导致回复篇幅更长、速率更慢，所以极易因超时导致任务失败。尤其在非流式输出模式下，任务未完成时断开连接，未输出内容，又产生 token 用量费用。
可使用流式输出或设置更长超时时间，减少超时失败：
- 使用流式输出（推荐）：通过分块即时返回生成内容，可有效维持连接活性（避免因长时无响应导致的连接中断），是高效且可靠的输出方式（示例代码及说明参见流式输出）。若当前应用使用非流式输出，可改造为：通过流式接口获取内容，实时拼接完整结果后再统一输出，从而显著降低请求超时失败风险。
- 调大超时时间参数：非流式输出场景下，推荐将 timeout 参数设置为 30 分钟以上，并根据超时触发概率进一步调整超时时间。另需注意网络链路中的 TCP Keep-Alive 设置（tcp_keepalive_time 参数），避免因长时间无数据传输导致连接被系统、防火墙、路由器等中断。
方舟 Go SDK 特殊说明：无论是否使用流式输出，均需将 SDK 超时参数设置为 30 分钟以上。
使用批量推理获得更高吞吐
当您的业务需要处理大量的数据，且对于模型返回及时性要求不高，您可使用批量推理获取最低 10B token/天的配额以及批量推理的成本降低。批量推理支持任务的方式以及类似 Chat 的接口调用方式，使用批量推理，详细说明请查看 批量推理。
提示词优化建议
深度思考模型会自行分析和拆解问题（思维链），与普通模型相比，提示词侧重点有所不同。
- 提示词除了待解决问题，应该更多补充目标和场景等信息。如使用英语，用 Python 等语言要求；面向小学生、向领导汇报等阅读对象信息；完成论文写作、完成课题报告、撰写剧本等场景信息；体现我的专业性、获得领导赏识等目标信息。
- 减少或者避免对问题的拆解描述，如分步骤思考、使用示例等，这样会限制住模型的推理逻辑。
- 减少使用系统提示词，所有提示词信息直接通过用户提示词（role: user）来提问。
常见问题
最近更新时间：2026.10.28 20:32:45
这个页面对您有帮助吗？
有用
有用
无用
无用