弃用说明 - Krea

概述

当 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 字段。

​概述

​当前已下线

​seedream3

​seedance-1-0-lite

​sora-2

​如何在代码中检测弃用

概述

当前已下线

seedream3

seedance-1-0-lite

sora-2

如何在代码中检测弃用