Skip to main content

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

​
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. 
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
Se chiami l’API tramite MCP, aggiorna l’argomento model: 
- { "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. 
- 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: 
- { "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 — 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à. 
- 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: 
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.