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

# Deprecazioni

> Tieni traccia dei modelli e degli endpoint della Krea API che sono deprecati o programmati per la dismissione, con consigli sui sostituti e indicazioni di migrazione per ciascuno.

## Panoramica

Quando un modello nella Krea API viene deprecato, lo comunichiamo attraverso tre canali in modo che la tua integrazione possa reagire automaticamente:

* **Intestazioni HTTP** su ogni risposta riuscita da un endpoint deprecato:
  * `Deprecation: true`
  * `Sunset: Mon, 27 Apr 2026 00:00:00 GMT` — quando l’endpoint smetterà di accettare richieste (data RFC 1123)
  * `Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html"` — punta alla voce in questa pagina
* **OpenAPI**: l’operazione è contrassegnata come `deprecated: true` e la descrizione inizia con un blocco di avviso.
* **MCP `list_models`**: i modelli deprecati includono un oggetto `deprecation` insieme al loro schema.

Dopo la data di dismissione, l’endpoint restituisce `410 Gone` con un corpo strutturato:

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

Il campo `error` è stabile e sicuro da utilizzare in uno switch. I campi `replacement` e `migration_url` sono presenti quando esiste un sostituto consigliato.

<Note>
  La dismissione viene applicata lato server nel momento in cui la data passa. Il tuo codice dovrebbe trattare qualsiasi `410` da un
  endpoint di modello come terminale — riprovare non aiuterà.
</Note>

## Attualmente Dismessi

### seedream3

**Dismesso il 2026-05-13.** Il modello è stato deprecato da ByteDance.

**Migrazione**: cambia il percorso della richiesta da `image/bytedance/seedream-3` a **`image/bytedance/seedream-5-lite`**.

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

Se chiami l’API tramite MCP, aggiorna l’argomento `model`:

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

### seedance-1-0-lite

**Dismesso il 2026-04-27.** Il provider ha interrotto questo modello.

**Migrazione**: cambia il percorso della richiesta da `video/bytedance/seedance-1.0-lite` a **`video/bytedance/seedance-1.0-pro-fast`**. Le forme di richiesta e risposta sono altrimenti compatibili.

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

Se chiami l’API tramite MCP, aggiorna l’argomento `model`:

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

### sora-2

**Dismesso il 2026-04-27.** Il provider ha interrotto questo modello.

Al momento non esiste un sostituto diretto. Se stavi usando `video/openai/sora-2`, valuta altri modelli text-to-video nel nostro catalogo [Video](/developers/examples/text-to-video) — `video/google/veo-3.1`, `video/runway/gen-4.5` e `video/bytedance/seedance-1.0-pro` sono le opzioni più vicine per clip brevi di alta qualità.

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

## Come rilevare la deprecazione nel tuo codice

Se vuoi individuare le deprecazioni prima della dismissione anziché reagire al `410`, controlla l’intestazione `Deprecation: true` su ogni risposta e riportala nei log o negli alert. Un esempio minimo:

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

Per i client MCP, ispeziona il campo `deprecation` su ciascun modello restituito da `list_models` e `get_model_schema`.