> ## 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 中已弃用或计划下线的模型和端点，了解 Deprecation 与 Sunset 响应头等通知机制、替代模型和迁移指引。

## 概述

当 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={"theme":{"light":"github-light-default","dark":"vesper"}}
{
	"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` 响应视为终态——重试无济于事。

## 计划下线

### krea-3-thinking-mode-values

**将于 2026-10-30 下线。** Krea 3（`image/krea/krea-3`）的旧版 `thinking_mode` 值已重命名。

在下线日期之前，旧值仍然可用，响应中会附带弃用响应头。下线日期之后，使用旧值的请求将被拒绝。

**迁移**：发送新值。

| 旧值 | 新值 |
| - | - |
| `instant` | `fast` |
| `medium` | `high` |
| `max` | `ultra` |

```diff theme={"theme":{"light":"github-light-default","dark":"vesper"}}
- { "prompt": "...", "thinking_mode": "instant" }
+ { "prompt": "...", "thinking_mode": "fast" }
```

请参阅 [Krea 3 思考模式](https://www.krea.ai/docs/cn/developers/krea-3/overview.md#thinking-modes)。

## 当前已下线

### gpt-image

**已于 2026-10-23 下线。** OpenAI 已停用 `gpt-image-1`，即 `image/openai/gpt-image` 背后的模型。

**迁移**：将请求路径从 `image/openai/gpt-image` 切换到 **`image/openai/gpt-image-2`**。`prompt`、`quality` 和 `imageUrls` 可继续使用；`gpt-image-2` 不支持 `presetStyles`。

```diff theme={"theme":{"light":"github-light-default","dark":"vesper"}}
- POST /generate/image/openai/gpt-image
+ POST /generate/image/openai/gpt-image-2
```

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

```diff theme={"theme":{"light":"github-light-default","dark":"vesper"}}
- { "model": "image/openai/gpt-image", "input": { ... } }
+ { "model": "image/openai/gpt-image-2", "input": { ... } }
```

### seedream3

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

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

```diff theme={"theme":{"light":"github-light-default","dark":"vesper"}}
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
```

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

```diff theme={"theme":{"light":"github-light-default","dark":"vesper"}}
- { "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={"theme":{"light":"github-light-default","dark":"vesper"}}
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
```

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

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

```diff theme={"theme":{"light":"github-light-default","dark":"vesper"}}
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>
```

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

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

```javascript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
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` 字段。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.