Skip to main content

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:
{
	"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.
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.

Currently Sunset

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.
- 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:
- { "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 catalog — video/google/veo-3.1, video/runway/gen-4.5, and video/bytedance/seedance-2 are the closest options for high-quality short clips.
- 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:
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.