> ## 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.

# Dépréciations

> Suivez les modèles et endpoints de l'API Krea qui sont dépréciés ou dont la mise hors service est planifiée, avec les recommandations de remplacement et les guides de migration pour chacun.

## 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é :

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

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.

<Note>
  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.
</Note>

## 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`**.

```diff theme={null}
- 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` :

```diff theme={null}
- { "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.

```diff theme={null}
- 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` :

```diff theme={null}
- { "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](/developers/examples/text-to-video) — `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é.

```diff theme={null}
- 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 :

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

Pour les clients MCP, inspectez le champ `deprecation` sur chaque modèle renvoyé par `list_models` et `get_model_schema`.
