# 下线模型迁移说明

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

随着火山方舟平台模型的升级，旧版本模型将逐步下线。模型正式下线（EOS）后，未及时迁移的推理接入点将被系统自动替换为建议迁移模型或直接关停，下线计划与各批次模型列表参见[模型下线公告](/docs/model-deprecation-notice)。下线模型与迁移目标模型在 API 参数支持上存在差异：部分模型不支持 `thinking`、`reasoning_effort`、`detail`、`thinking summary` 等参数。系统自动迁移时，仅 `thinking` 参数会自动生效；`reasoning_effort`、`detail` 等其他参数不会自动生效，需要你在迁移后自行手动修改调用代码。

本文以下线公告中的模型为例，介绍迁移前后各 API 参数的差异，帮助你提前检查并调整调用参数，避免迁移后出现调用报错或效果波动。

> **注意**
>
> 不同模型/版本支持的能力、API 参数、单价、任务中实际表现存在差异，迁移前请务必仔细阅读模型介绍，并进行必要评测，比较迁移前后模型的表现。
>
> 特别注意：系统自动迁移时，仅 `thinking` 参数会自动生效；`reasoning_effort`、`detail`、`thinking summary` 等其他参数不会自动生效，你需要在迁移后自行手动修改调用代码，否则可能导致调用报错。

<span id="a3c81e02"></span>
# thinking（开启/关闭深度思考）

`thinking` 字段用于控制是否开启深度思考，取值为 `enabled`（默认）、`disabled`，部分模型支持 `auto`。详细说明参见[深度思考](/docs/deep-thinking)。

|**下线模型 ID** |**thinking 支持情况** |**迁移后需要关注** |
|---|---|---|
|kimi-k2-5-260127 |不支持 |thinking 为 `disabled` |
|doubao-1-5-lite-32k-250115 |^^ |^^ |
|doubao-1-5-vision-pro-32k-250115 |^^ |^^ |
|doubao-1-5-pro-32k-250115 |^^ |^^ |
|doubao-1-5-pro-32k-character-250715 |^^ |^^ |
|doubao-seedance-1-5-pro-251215 |^^ |^^ |
|glm-4-7-251222 |`enabled`（默认）/ `disabled` |与原模型 thinking 取值一致 |
|deepseek-v3-2-251201 |^^ |^^ |
|doubao-seed-code-preview-251028 |^^ |^^ |
|doubao-seed-1-6-vision-250815 |^^ |^^ |
|doubao-seed-1-6-flash-250828 |^^ |^^ |
|doubao-seed-1-6-flash-250615 |^^ |^^ |
|doubao-seed-1-6-251015 |^^ |^^ |
|doubao-seed-1-8-251228 |^^ |^^ |
|deepseek-v4-flash-260425 |^^ |^^ |
|doubao-seed-1-6-250615 |`enabled`（默认）/ `disabled` / `auto` |与原模型 thinking 取值一致 |

**迁移建议：**
* 原模型不支持 `thinking`：自动迁移后接入点的 thinking 为 `disabled`，行为与原模型一致，调用代码无需调整。若希望在迁移模型上开启深度思考，可在请求中显式传入 `"thinking": {"type": "enabled"}`。
* 原模型支持 `thinking`：自动迁移后与原取值一致，调用代码无需调整；手动切换模型时建议保持原取值，并确认目标模型的 `thinking` 支持情况。
* 若迁移目标模型不支持 `thinking`（如 `doubao-seedance-2-0-mini-260615`），请从请求中移除该参数。

<span id="b7d4f19a"></span>
# reasoning_effort（调节思考长度）

`reasoning_effort`（Chat API）/ `reasoning.effort`（Responses API）字段用于调节思维链长度，取值为 `none`、`minimal`、`low`、`medium`、`high`、`xhigh`、`max`。详细说明参见[深度思考](/docs/deep-thinking)。

|**下线模型 ID** |**reasoning_effort 支持情况** |**默认取值** |**兼容映射** |**thinking 支持情况** |**迁移后需要关注** |
|---|---|---|---|---|---|
|kimi-k2-5-260127 |不支持 |— |— |不支持 |thinking 为 `disabled`，reasoning_effort 不会自动生效 |
|doubao-1-5-lite-32k-250115 |^^ |^^ |^^ |^^ |^^ |
|doubao-1-5-vision-pro-32k-250115 |^^ |^^ |^^ |^^ |^^ |
|doubao-1-5-pro-32k-250115 |^^ |^^ |^^ |^^ |^^ |
|doubao-1-5-pro-32k-character-250715 |^^ |^^ |^^ |^^ |^^ |
|doubao-seedance-1-5-pro-251215 |^^ |^^ |^^ |^^ |^^ |
|glm-4-7-251222 |不支持 |— |— |`enabled`（默认）/ `disabled` |reasoning_effort 不会自动生效 |
|deepseek-v3-2-251201 |^^ |^^ |^^ |^^ |^^ |
|doubao-seed-code-preview-251028 |^^ |^^ |^^ |^^ |^^ |
|doubao-seed-1-6-vision-250815 |^^ |^^ |^^ |^^ |^^ |
|doubao-seed-1-6-250615 |^^ |^^ |^^ |^^ |^^ |
|doubao-seed-1-6-flash-250828 |^^ |^^ |^^ |^^ |^^ |
|doubao-seed-1-6-flash-250615 |^^ |^^ |^^ |^^ |^^ |
|deepseek-v4-flash-260425 |支持 |`high` |`minimal`→关闭思考，`none`→`minimal`，`low`/`medium`→`high`，`xhigh`→`max` |`enabled`（默认）/ `disabled` |reasoning_effort 不会自动生效，需手动设置 |
|doubao-seed-1-8-251228 |支持 |`medium` |`minimal`→关闭思考，`none`→`minimal`，`xhigh`/`max`→`high` |`enabled`（默认）/ `disabled` |reasoning_effort 不会自动生效，需手动设置 |
|doubao-seed-1-6-251015 |支持 |`medium` |`minimal`→关闭思考，`none`→`minimal`，`xhigh`/`max`→`high` |`enabled`（默认）/ `disabled` |reasoning_effort 不会自动生效，需手动设置 |

**迁移建议：**
* 系统自动迁移时 `reasoning_effort` 不会自动生效，需要手动修改调用代码：目标模型不支持该参数时，请从请求中移除，避免调用报错。
* 目标模型支持 `reasoning_effort` 时，请按目标模型的默认取值与兼容映射，在请求中手动设置取值。

<span id="c92a6e4b"></span>
# thinking summary（思考内容摘要）

thinking summary 能力开启后，模型返回思考内容摘要（`reasoning_content`）与思考内容加密原文（`encrypted_content`），而不是输出原始思考内容。详细说明参见[深度思考](/docs/deep-thinking)。

> **注意**
>
> 特别注意回传行为：开启 thinking summary 后返回的是思考内容摘要与加密原文，Agent 场景（多轮工具调用等）下需要将加密原文按规范回传给模型，否则会影响推理效果。Agent 场景的正确调用与回传姿势参见[Agent 场景模型调用的正确姿势](/docs/agent-model-invocation-practice)。

下线模型均不支持 thinking summary。迁移后是否支持取决于建议迁移模型：

|**下线模型 ID** |**thinking summary 支持情况** |**建议迁移模型** |**迁移后 thinking summary 支持情况** |
|---|---|---|---|
|kimi-k2-5-260127 |不支持 |doubao-seed-evolving |支持 |
|doubao-1-5-vision-pro-32k-250115 |^^ |doubao-seed-2-0-lite-260428 |^^ |
|doubao-1-5-pro-32k-250115 |^^ |doubao-seed-2-0-lite-260428 |^^ |
|doubao-seed-code-preview-251028 |^^ |doubao-seed-evolving |^^ |
|doubao-seed-1-6-vision-250815 |^^ |doubao-seed-2-0-lite-260428 |^^ |
|doubao-seed-1-6-250615 |^^ |doubao-seed-2-0-lite-260428 |^^ |
|doubao-seed-1-6-251015 |^^ |doubao-seed-2-0-lite-260428 |^^ |
|doubao-seed-1-8-251228 |^^ |doubao-seed-2-0-lite-260428 |^^ |
|deepseek-v3-2-251201 |不支持 |deepseek-v4-flash-ga-260731 |不支持 |
|doubao-1-5-lite-32k-250115 |^^ |doubao-seed-2-0-mini-260428 |^^ |
|doubao-1-5-pro-32k-character-250715 |^^ |doubao-seed-character-260628 |^^ |
|doubao-seedance-1-5-pro-251215 |^^ |doubao-seedance-2-0-mini-260615 |^^ |
|glm-4-7-251222 |^^ |glm-5-2-260617 |^^ |
|doubao-seed-1-6-flash-250828 |^^ |doubao-seed-2-0-mini-260428 |^^ |
|doubao-seed-1-6-flash-250615 |^^ |doubao-seed-2-0-mini-260428 |^^ |
|deepseek-v4-flash-260425 |^^ |deepseek-v4-flash-ga-260731 |^^ |

**迁移建议：**
* 系统自动迁移时 thinking summary 不会自动生效：迁移到支持 thinking summary 的模型后，需按模型介绍自行开启并适配，开启后响应中将包含思考内容摘要（`reasoning_content`）与加密原文（`encrypted_content`）。由于可能产生较高的包间延迟，请调大请求超时时间（`timeout`）。
* 迁移到不支持 thinking summary 的模型后，不返回上述摘要相关字段。
* 若不希望迁移后返回摘要内容，请通过模型介绍确认目标模型的关闭方式。

<span id="d8f5b2c7"></span>
# detail（图片理解精细度）

`detail` 参数用于控制模型理解图片的精细度，在 `image_url` 中传入，详细说明参见[图片理解](/docs/image-understanding)。系统自动迁移时 `detail` 参数不会自动生效，需要在迁移后手动修改调用代码，可参考以下规则：

* 不支持图片理解的模型：迁移到新模型后，`detail` 建议设置为 `low`。
* doubao-seed-1.8 之前且支持图片理解的模型：原模型 detail 使用默认值，切换到 doubao-seed-2.0 新模型后，`detail` 建议设置为 `low`。
* doubao-seed-1.8 模型及后续模型：切换到新模型后，建议在请求中保持与原模型一致的 `detail` 取值。

**迁移建议：** 若业务对图片理解精细度有要求（如需要 `high` 及以上档位），请在迁移后检查请求中 `image_url` 的 `detail` 取值，并按目标模型支持的模式显式设置。

<span id="e1a93f60"></span>
# 建议迁移模型的参数支持总览

|**模型 ID** |**thinking 支持情况** |**reasoning_effort 支持情况** |**默认取值** |**兼容映射** |**thinking summary 支持情况** |
|---|---|---|---|---|---|
|doubao-seed-evolving |`enabled`（默认）/ `disabled` |支持 |`high` |`minimal`→关闭思考，`none`→`minimal`，`xhigh`/`max`→`high` |支持 |
|glm-5-2-260617 |`enabled`（默认）/ `disabled` |支持 |`high` |`none`/`minimal`→关闭思考，`low`/`medium`→`high`，`xhigh`→`max` |不支持 |
|deepseek-v4-flash-ga-260731 |`enabled`（默认）/ `disabled` |支持 |`high` |`none`/`minimal`→关闭思考，`medium`→`low`，`xhigh`→`high` |不支持 |
|doubao-seed-2-0-lite-260428 |`enabled`（默认）/ `disabled` |支持 |`medium` |`minimal`→关闭思考，`none`→`minimal`，`xhigh`/`max`→`high` |支持 |
|doubao-seed-2-0-mini-260428 |`enabled`（默认）/ `disabled` |支持 |`medium` |`minimal`→关闭思考，`none`→`minimal`，`xhigh`/`max`→`high` |不支持 |
|doubao-seed-character-260628 |`enabled`（默认）/ `disabled` |支持 |`medium` |`minimal`→关闭思考，`none`→`minimal`，`xhigh`/`max`→`high` |不支持 |
|doubao-seedance-2-0-mini-260615 |不支持 |不支持 |— |— |不支持 |

<span id="f6c8d1e3"></span>
# 迁移操作建议

1. **确认下线计划与建议迁移模型**：在[模型下线公告](/docs/model-deprecation-notice)中查看你使用的模型所属批次、下线时间及建议迁移模型。
2. **检查调用参数**：系统自动迁移时仅 `thinking` 参数会自动生效，其余参数需手动修改调用代码。按下文清单检查请求中与深度思考、图片理解相关的参数，并对照本文各参数差异表调整：
   * `thinking`：目标模型不支持时移除；支持时确认取值。
   * `reasoning_effort`（Responses API 为 `reasoning.effort`）：目标模型不支持时移除；支持时按兼容映射确认取值。
   * `image_url` 中的 `detail`：按 detail 参数变化规则确认取值。
   * thinking summary 相关字段（`reasoning_content`、`encrypted_content`）：按目标模型支持情况调整解析逻辑与超时时间。
3. **提前切换并评测**：建议在模型下线前，通过推理接入点平滑切换能力提前切换到目标模型并完成评测，切换步骤参见[切换模型步骤](/docs/model-deprecation-notice#model-switching-notes)。
4. **未及时迁移**：模型下线当日，系统会将残留接入点自动替换为建议迁移模型或直接关停，自动迁移的模型与原模型可能存在价格波动，请关注价格变化，合理规划使用成本。

以下为调整调用参数的示例：原请求调用 `doubao-seed-1-6-251015` 并显式设置思考参数，迁移到 `doubao-seed-2-0-lite-260428` 后取值保持兼容，无需修改：

|场景 |请求示例 |
|---|---|
|迁移前（下线模型） |```JSON | \
| |{ | \
| |    "model": "doubao-seed-1-6-251015", | \
| |    "messages": [ | \
| |        {"role": "user", "content": "介绍一下深度思考"} | \
| |    ], | \
| |    "thinking": {"type": "enabled"}, | \
| |    "reasoning_effort": "medium" | \
| |} | \
| |``` |
|迁移后（支持思考参数的模型，取值无需调整） |```JSON | \
| |{ | \
| |    "model": "doubao-seed-2-0-lite-260428", | \
| |    "messages": [ | \
| |        {"role": "user", "content": "介绍一下深度思考"} | \
| |    ], | \
| |    "thinking": {"type": "enabled"}, | \
| |    "reasoning_effort": "medium" | \
| |} | \
| |``` |

如有其他迁移问题，可以通过提交 [工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00001166) 的方式，进行咨询。