Skip to main content

Überblick

Wenn ein Modell in der Krea-API als veraltet markiert wird, kommunizieren wir das über drei Kanäle, damit deine Integration automatisch reagieren kann:
  • HTTP-Header bei jeder erfolgreichen Antwort eines veralteten Endpunkts:
    • Deprecation: true
    • Sunset: Mon, 27 Apr 2026 00:00:00 GMT — wann der Endpunkt keine Anfragen mehr annimmt (Datum im RFC-1123-Format)
    • Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — verweist auf den Eintrag auf dieser Seite
  • OpenAPI: Die Operation ist mit deprecated: true gekennzeichnet und die Beschreibung beginnt mit einem Warnblock.
  • MCP list_models: Veraltete Modelle enthalten neben ihrem Schema ein deprecation-Objekt.
Nach dem Sunset-Datum liefert der Endpunkt 410 Gone mit einem strukturierten 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"
}
Das Feld error ist stabil und eignet sich für Fallunterscheidungen. Die Felder replacement und migration_url sind vorhanden, wenn ein empfohlener Ersatz existiert.
Das Sunset wird serverseitig genau in dem Moment durchgesetzt, in dem das Datum überschritten wird. Dein Code sollte jedes 410 von einem Modellendpunkt als endgültig behandeln — ein erneuter Versuch bringt nichts.

Aktuell abgeschaltet

seedream3

Abgeschaltet am 2026-05-13. Das Modell wurde von ByteDance eingestellt. Migration: Ändere deinen Anfrage-Pfad von image/bytedance/seedream-3 auf image/bytedance/seedream-5-lite.
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
Wenn du die API über MCP aufrufst, aktualisiere das Argument model:
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

seedance-1-0-lite

Abgeschaltet am 2026-04-27. Der Anbieter hat dieses Modell eingestellt. Migration: Ändere deinen Anfrage-Pfad von video/bytedance/seedance-1.0-lite auf video/bytedance/seedance-1.0-pro-fast. Anfrage- und Antwortformat sind ansonsten kompatibel.
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
Wenn du die API über MCP aufrufst, aktualisiere das Argument model:
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

sora-2

Abgeschaltet am 2026-04-27. Der Anbieter hat dieses Modell eingestellt. Derzeit gibt es keinen direkten Ersatz. Wenn du video/openai/sora-2 verwendet hast, prüfe andere Text-zu-Video-Modelle in unserem Video-Katalog — video/google/veo-3.1, video/runway/gen-4.5 und video/bytedance/seedance-1.0-pro sind die naheliegendsten Alternativen für hochwertige kurze Clips.
- POST /generate/video/openai/sora-2
+ POST /generate/video/<gewählter-ersatz>

So erkennst du eine Deprecation in deinem Code

Wenn du Deprecations schon vor dem Sunset abfangen willst, statt erst auf 410 zu reagieren, achte auf den Header Deprecation: true in jeder Antwort und protokolliere ihn in deinen Logs oder Alerts. Ein minimales Beispiel:
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}`);
}
Für MCP-Clients: Prüfe das Feld deprecation an jedem Modell, das von list_models und get_model_schema zurückgegeben wird.