# Seed-Evolving

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

Seed-Evolving 是面向 Agent 与 Coding 场景打造的 Seed 系列模型，具备复杂任务编排、长程规划、代码生成与工具调用能力。统一调用 Model ID `doubao-seed-evolving`，无需关注版本切换，即可持续获得最新模型能力。最新版本在 Agent 长程执行、可信调研与多模态理解方面的能力全面增强。

> **警告：重要注意事项**
>
> Seed-Evolving 模型调用时，建议先参考 [Agent 场景模型调用的正确姿势](/docs/agent-model-invocation-practice)，按推荐方式**回传思考内容加密原文**、配置关键参数，并在同一 Session 内保持调用配置不变，以获得更稳定的模型推理效果。

<span id="model-advantages"></span>
## 模型核心优势

<div style="min-height: 110px; width: 100%;">

**始终最新 | 一个 Model ID，无感获取新版本**

模型升级自动生效，无需迁移 Endpoint 或调整调用方式。

</div>

<div style="min-height: 110px; width: 100%;">

**快速迭代 | 聚焦真实场景持续优化**

围绕代码生成、工具调用、任务规划与长程执行等核心任务滚动升级。

</div>

## 最新更新亮点

**版本更新时间：2026/09/09**

更强的 Agent 执行能力与多模态理解，是本次更新的两大核心升级。模型能够持续推进复杂任务、协同并验收异步子任务，将图片、视频和页面理解用于推理判断与实际操作，让深度调研、办公协作和长程任务的交付更稳健。

<div style="min-height: 180px;">

**Agent | 复杂任务持续执行与验收**

* **复杂多步骤、长周期任务稳健推进**，强化任务拆解、持续规划与工具协同，将工作推进到可验收的成果
* **异步子任务协同与验收更可靠**，依据真实状态和返回结果确认完成，减少提前收尾与反复返工

</div>

<div style="min-height: 180px;">

**多模态理解 | 理解深入，响应高效**

* **图片、视频理解与视觉推理能力增强**，深入理解视觉信息中的逻辑关系，为真实环境感知与操作判断提供支撑
* **理解效果与处理效率同步提升**，图片和视频理解任务耗时较上一代减少 40%

</div>

<div style="min-height: 180px;">

**深度调研 | 可信分析，专业交付**

* 强化**证据溯源、资料时效判断、来源权威性与数据核验**，让研究结论有据可查，深度分析更可靠
* **金融投研展现专家级研究深度与洞察力**，金融建模计算可信度与研究报告交付质量大幅提升

</div>

<div style="min-height: 180px;">

**工具执行 | 减少幻觉，反馈可信**

* **Agent 幻觉大幅减少**，调用必要工具取证、等待真实结果并检查返回内容，让回复忠于事实与实际执行
* **如实说明工具不可用、证据不足与结论边界**，保留不确定性，减少编造结果或提前宣告完成

</div>

<div style="min-height: 180px;">

**Office 办公 | 全局一致，跨应用协同**

* **文档、PPT 与表格的生成、修改和核验更实用**，优化基础版式、全局修改一致性，以及修改后的回读与视觉验收
* 结合**多模态理解与 Computer Use**，衔接浏览器、文档、表格和文件操作，支持跨软件办公流程

</div>

<div style="min-height: 180px;">

**Coding | 从设计还原到工程实践**

* **视觉理解赋能前端开发**，理解设计图中的布局、样式与细节，支持 Web 界面还原与应用开发
* 覆盖**自然语言驱动的新项目构建、环境部署与运维**，衔接代码生成、终端操作与工程任务执行

</div>

<span id="model-capabilities"></span>
## 模型能力

[文本生成](/docs/text-generation)
Supported

[深度思考](/docs/deep-thinking)
Supported

[函数调用](/docs/function-calling)
Supported

[上下文缓存](/docs/context-cache)
Supported

<!-- <Card mode="section" href="/docs/batch-inference" icon="https://arkdocs.tos-cn-beijing.volces.com/images/get-started/batch.svg" iconSize="s" horizontal="true">

批量推理
Supported

</Card> -->

[文档理解](/docs/document-understanding)
Supported

[结构化输出](/docs/structured-output-beta)
Supported

[图片理解](/docs/image-understanding)
Supported

[视频理解](/docs/video-understanding)
Supported

<span id="model-limits"></span>
## 模型限制

**长度限制（token）**
上下文窗口：1024k                 |       最大输入长度：1024k
最大思维链内容长度：256k          |       最大输出长度：256k  

**模型限流**
最大 RPM：500
最大 TPM：1,000,000

<span id="usage-notes"></span>
## 使用说明

<span id="deep-thinking"></span>
### 深度思考

- 深度思考开关：通过 `thinking` 参数控制模型是否开启深度思考模式，默认开启思考。
- 调节思考长度：通过 `reasoning_effort` 参数调节思考长度，支持 `none`、`minimal`、`low`、`medium`、`high`、`xhigh`、`max` 七种模式，默认开启 `high` 模式。
- 输出思考内容摘要：默认开启 thinking summary 能力，不会输出模型原始的思考内容，会返回模型思考内容摘要和思考内容加密原文。建议全量回传，服务端会基于场景判断是否会丢弃思维链内容。具体见[回传思考内容加密原文](/docs/deep-thinking#8cfd447b)。
  - Chat API：回传 `encrypted_content` 字段。
  - Responses API：推荐使用 `previous_response_id` 回传。

<span id="multimodal-understanding"></span>
### 多模态理解

- Doubao-Seed-Evolving 面向 Coding 和 Agent 场景，支持图片、视频、文本理解，未支持音频理解及视频中的音频理解。
- 图片理解：通过 `detail` 参数控制模型理解图片的精细度，支持 `low`、`high`、`xhigh` 三种模式，默认值为 `high`。不同模式支持的单图 token 范围和图片像素区间如下。教程参见[图片理解](/docs/image-understanding)。

| detail 模式 | 单图 token 范围 | 图片像素区间 |
| --- | --- | --- |
| `low` | [1, 1280] | [1764, 2257920] |
| `high` | 1280 | 2257920 |
| `xhigh` | [1280, 5120] | [2257920, 9031680] |

* 视频理解：通过 fps 控制视频理解的精细度，教程参见[视频理解](/docs/video-understanding)。
* Files API 上传：如果图片、视频、文档文件超过 10 MB，建议使用 Files API 上传，通过 File ID 方式进行多模态理解。

<span id="tool-calling"></span>
### 工具调用

工具调用场景开启深度思考后，为给出更详尽准确的回答，将不会直接丢弃思维链内容，思维链内容可能参与后续轮次推理，输入 token 会增加。建议全量回传思考内容，服务端会基于场景判断是否会丢弃思维链内容。具体原理及请求示例参见[工具调用场景](/docs/context-management#a0247227)。

|流程图 |说明 |
|---|---|
|![](https://arkdocs.tos-cn-beijing.volces.com/flowcharts/advanced-usage/context-management-03.svg) |* 回答问题 1 时（请求 1.1 - 1.2），模型进行多次思考 + 工具调用后给出答案，方舟会输入完整上下文包括思维链内容给模型处理。 | \
| |* 开始回答问题2时（请求 2.1），方舟会自行判断并删除之前上下文中的思维链，输入给模型。 |

<span id="context-caching"></span>
### 上下文缓存

利用缓存机制复用计算结果，避免模型对相同内容的重复处理，降低 token 成本。具体使用见[上下文缓存](/docs/context-cache)。

* 隐式缓存：自动模式，用户无需做额外配置。系统会自动识别请求中的公共前缀并进行缓存，但不保证缓存命中。支持 Responses API、Chat API，默认开启。
* 显式缓存：需要显式创建缓存，但能实现更高的缓存命中率。支持 Responses API，提供前缀缓存、Session 缓存。

### 接入三方工具

方舟 API 兼容 OpenAI 和 Anthropic 接口协议，支持在三方工具中使用，如 Claude Code、OpenCode、Codex，具体见[接入三方工具](/docs/integrate-third-party-tools)。

<span id="model-migration"></span>
## 模型迁移

在 AI Agent 工具中使用 `ark-docs-assistant` Skill 进行模型升级/迁移分析，以及代码项目中的模型引用判断与替换风险分析。

1. 前提条件：需要安装 `ark-docs-mcp`，安装及使用参考[方舟文档 MCP](/docs/tutorials-mcp)。
2. 推荐在项目根目录运行以下命令，通过方舟文档 Skills catalog 安装 `ark-docs-assistant` Skill。

    ```bash
    npx --yes skills@latest add "https://arkdocs.tos-cn-beijing.volces.com/skills/" \
      --skill ark-docs-assistant \
      --yes
    ```

    如需手动安装，可以下载 [ark-docs-assistant-0.1.0.zip](https://arkdocs.tos-cn-beijing.volces.com/skills/artifacts/docs-platform/ark-docs-assistant/0.1.0/ark-docs-assistant-0.1.0.zip)，解压后将 Skill 目录放入对应 Agent 的 skills 目录。

3. 在 Agent 中触发该 Skill 的方式可参见：

    ```text
    * 我可以将 doubao-seed-2-0-lite 升级到最新模型吗？
    * 扫描当前项目，将目标模型升级为最新模型，先给出迁移清单，不要直接修改。
    ```