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

# Deprecations

> Models and endpoints that are deprecated or sunset, and how to migrate.

## Overview

When a model in the Krea API is deprecated, we communicate it through three channels so your integration can react automatically:

* **HTTP headers** on every successful response from a deprecated endpoint:
  * `Deprecation: true`
  * `Sunset: Mon, 27 Apr 2026 00:00:00 GMT` — when the endpoint will stop accepting requests (RFC 1123 date)
  * `Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html"` — points to the entry on this page
* **OpenAPI**: the operation is marked `deprecated: true` and the description starts with a warning block.
* **MCP `list_models`**: deprecated models include a `deprecation` object alongside their schema.

After the sunset date, the endpoint returns `410 Gone` with a structured body:

```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"
}
```

The `error` field is stable and safe to switch on. The `replacement` and `migration_url` fields are present when a recommended replacement exists.

<Note>
  Sunset is enforced server-side at the moment the date passes. Your code should treat any `410` from a
  model endpoint as terminal — retrying will not help.
</Note>

## Currently Sunset

### seedream3

**Sunset on 2026-05-13.** The model was deprecated by ByteDance.

**Migration**: switch your request path from `image/bytedance/seedream-3` to **`image/bytedance/seedream-5-lite`**.

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

If you call the API via MCP, update the `model` argument:

```diff theme={null}
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }
```

### seedance-1-0-lite

**Sunset on 2026-04-27.** The provider has discontinued this model.

**Migration**: switch your request path from `video/bytedance/seedance-1.0-lite` to **`video/bytedance/seedance-1.0-pro-fast`**. The request and response shapes are otherwise compatible.

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

If you call the API via MCP, update the `model` argument:

```diff theme={null}
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }
```

### sora-2

**Sunset on 2026-04-27.** The provider has discontinued this model.

There is no drop-in replacement at this time. If you were using `video/openai/sora-2`, evaluate other text-to-video models in our [Video](/api-reference/v1/post-generate-video-runway-gen-4-video) catalog — `video/google/veo-3.1`, `video/runway/gen-4.5`, and `video/bytedance/seedance-1.0-pro` are the closest options for high-quality short clips.

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

## How to detect deprecation in your code

If you want to catch deprecations before sunset rather than reacting to `410`, watch for the `Deprecation: true` header on any response and surface it in your logs or alerts. A minimal example:

```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}`);
}
```

For MCP clients, inspect the `deprecation` field on each model returned by `list_models` and `get_model_schema`.