Skip to main content

​
Aperçu

Lorsqu’un modèle de l’API Krea est déprécié, nous le communiquons via trois canaux afin que votre intégration puisse réagir automatiquement :
  • En-têtes HTTP sur chaque réponse réussie provenant d’un endpoint déprécié :
    • Deprecation: true
    • Sunset: Mon, 27 Apr 2026 00:00:00 GMT — quand l’endpoint cessera d’accepter les requêtes (date RFC 1123)
    • Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — pointe vers l’entrée sur cette page
  • OpenAPI : l’opération est marquée deprecated: true et la description commence par un bloc d’avertissement.
  • MCP list_models : les modèles dépréciés incluent un objet deprecation à côté de leur schéma.
Après la date de mise hors service (sunset), l’endpoint renvoie 410 Gone avec un corps structuré : 
{
	"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"
}
Le champ error est stable et peut être utilisé en toute sécurité dans un switch. Les champs replacement et migration_url sont présents lorsqu’un remplacement recommandé existe.
La mise hors service est appliquée côté serveur au moment où la date est atteinte. Votre code doit traiter tout 410 provenant d’un endpoint de modèle comme terminal — réessayer ne servira à rien.

​
Actuellement mis hors service

​
seedream3

Mis hors service le 2026-05-13. Le modèle a été déprécié par ByteDance. Migration : remplacez le chemin de votre requête image/bytedance/seedream-3 par image/bytedance/seedream-5-lite. 
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
Si vous appelez l’API via MCP, mettez à jour l’argument model : 
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

​
seedance-1-0-lite

Mis hors service le 2026-04-27. Le fournisseur a arrêté ce modèle. Migration : remplacez le chemin de votre requête video/bytedance/seedance-1.0-lite par video/bytedance/seedance-1.0-pro-fast. Les formes des requêtes et des réponses sont par ailleurs compatibles. 
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
Si vous appelez l’API via MCP, mettez à jour l’argument model : 
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

​
sora-2

Mis hors service le 2026-04-27. Le fournisseur a arrêté ce modèle. Il n’existe pas de remplacement direct pour le moment. Si vous utilisiez video/openai/sora-2, évaluez d’autres modèles de texte-vers-vidéo dans notre catalogue Vidéo — video/google/veo-3.1, video/runway/gen-4.5 et video/bytedance/seedance-1.0-pro sont les options les plus proches pour des clips courts de haute qualité. 
- POST /generate/video/openai/sora-2
+ POST /generate/video/<chosen-replacement>

​
Comment détecter une dépréciation dans votre code

Si vous voulez repérer les dépréciations avant la mise hors service plutôt que de réagir à un 410, surveillez l’en-tête Deprecation: true sur toute réponse et exposez-le dans vos logs ou alertes. Un exemple minimal : 
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}`);
}
Pour les clients MCP, inspectez le champ deprecation sur chaque modèle renvoyé par list_models et get_model_schema.