下线模型迁移说明

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

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

thinking（开启/关闭深度思考）#

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

迁移建议：

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

reasoning_effort（调节思考长度）#

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

迁移建议：

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

thinking summary（思考内容摘要）#

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

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

迁移建议：

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

detail（图片理解精细度）#

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

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

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

建议迁移模型的参数支持总览#

迁移操作建议#

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

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

1
2
3
4
5
6
7
8{
    "model": "doubao-seed-1-6-251015",
    "messages": [
        {"role": "user", "content": "介绍一下深度思考"}
    ],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "medium"
}

1
2
3
4
5
6
7
8{
    "model": "doubao-seed-2-0-lite-260428",
    "messages": [
        {"role": "user", "content": "介绍一下深度思考"}
    ],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "medium"
}

如有其他迁移问题，可以通过提交 工单 的方式，进行咨询。