Skip to main content

​
概述

当 Krea API 中的某个模型被弃用时，我们会通过三个渠道进行通知，方便你的集成自动做出响应：
  • 每次从已弃用端点成功返回的响应中都会附带 HTTP 请求头：
    • Deprecation: true
    • Sunset: Mon, 27 Apr 2026 00:00:00 GMT — 端点停止接受请求的时间（RFC 1123 日期格式）
    • Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — 指向本页对应条目
  • OpenAPI：该操作被标记为 deprecated: true，并且描述开头包含一段警告。
  • MCP list_models：已弃用的模型在其 schema 旁包含 deprecation 对象。
在下线日期之后，端点会返回 410 Gone，并附带结构化的响应体： 
{
	"error": "model_unavailable",
	"reason": "deprecated",
	"message": "The model 'video/bytedance/seedance-1.0-lite' was deprecated on 2026-04-27. Provider has discontinued this model. Use 'video/bytedance/seedance-1.0-pro-fast' instead.",
	"sunset_date": "2026-04-27",
	"replacement": "video/bytedance/seedance-1.0-pro-fast",
	"migration_url": "https://docs.krea.ai/developers/deprecations#seedance-1-0-lite"
}
error 字段是稳定的，可以安全地据此做分支判断。当存在推荐替代方案时，replacement 和 migration_url 字段会一并返回。
下线在到期时点由服务端强制生效。你的代码应把来自模型端点的任何 410 响应视为终态——重试无济于事。

​
当前已下线

​
seedream3

已于 2026-05-13 下线。 该模型已被 ByteDance 弃用。 迁移：将请求路径从 image/bytedance/seedream-3 切换到 image/bytedance/seedream-5-lite。 
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
如果你通过 MCP 调用 API，请更新 model 参数： 
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

​
seedance-1-0-lite

已于 2026-04-27 下线。 提供方已停止提供该模型。 迁移：将请求路径从 video/bytedance/seedance-1.0-lite 切换到 video/bytedance/seedance-1.0-pro-fast。请求和响应结构其他部分兼容。 
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
如果你通过 MCP 调用 API，请更新 model 参数： 
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

​
sora-2

已于 2026-04-27 下线。 提供方已停止提供该模型。 目前没有可直接替换的方案。如果你之前使用的是 video/openai/sora-2，请在 Video 目录中评估其他文本生成视频模型——video/google/veo-3.1、video/runway/gen-4.5 和 video/bytedance/seedance-1.0-pro 是最接近的高质量短片候选。 
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>

​
如何在代码中检测弃用

如果你希望在下线之前主动捕获弃用信息，而不是等到收到 410 再反应，可以在任意响应中查看 Deprecation: true 请求头，并将其打印到日志或告警中。最小示例： 
const response = await fetch(url, options);
if (response.headers.get('deprecation') === 'true') {
	const sunset = response.headers.get('sunset');
	const link = response.headers.get('link');
	console.warn(`Endpoint deprecated. Sunset: ${sunset}. Migration: ${link}`);
}
对于 MCP 客户端，请检查 list_models 和 get_model_schema 返回的每个模型上的 deprecation 字段。