> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 弃用说明

> 跟踪已弃用或计划下线的 Krea API 模型和端点，并为每一项提供替代建议和迁移指引。

## 概述

当 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`，并附带结构化的响应体：

```json theme={null}
{
	"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` 字段会一并返回。

<Note>
  下线在到期时点由服务端强制生效。你的代码应把来自模型端点的任何 `410` 响应视为终态——重试无济于事。
</Note>

## 当前已下线

### seedream3

**已于 2026-05-13 下线。** 该模型已被 ByteDance 弃用。

**迁移**：将请求路径从 `image/bytedance/seedream-3` 切换到 **`image/bytedance/seedream-5-lite`**。

```diff theme={null}
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
```

如果你通过 MCP 调用 API，请更新 `model` 参数：

```diff theme={null}
- { "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`**。请求和响应结构其他部分兼容。

```diff theme={null}
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
```

如果你通过 MCP 调用 API，请更新 `model` 参数：

```diff theme={null}
- { "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](/developers/examples/text-to-video) 目录中评估其他文本生成视频模型——`video/google/veo-3.1`、`video/runway/gen-4.5` 和 `video/bytedance/seedance-1.0-pro` 是最接近的高质量短片候选。

```diff theme={null}
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>
```

## 如何在代码中检测弃用

如果你希望在下线之前主动捕获弃用信息，而不是等到收到 `410` 再反应，可以在任意响应中查看 `Deprecation: true` 请求头，并将其打印到日志或告警中。最小示例：

```javascript theme={null}
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` 字段。