Vai al contenuto principale

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:
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à.

Dismissione programmata

krea-3-thinking-mode-values

Dismissione il 2026-10-30. I valori legacy di thinking_mode per Krea 3 (image/krea/krea-3) vengono rinominati. Fino alla data di dismissione, i vecchi valori continuano a funzionare e la risposta include gli header di deprecazione. Dopo la data di dismissione, le richieste con un vecchio valore vengono rifiutate. Migrazione: invia il nuovo valore.
Consulta Modalità di ragionamento di Krea 3.

Attualmente Dismessi

gpt-image

Dismesso il 2026-10-23. OpenAI ha dismesso gpt-image-1, il modello alla base di image/openai/gpt-image. Migrazione: cambia il percorso della richiesta da image/openai/gpt-image a image/openai/gpt-image-2. prompt, quality e imageUrls restano invariati; gpt-image-2 non accetta presetStyles.
Se chiami l’API tramite MCP, aggiorna l’argomento model:

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.
Se chiami l’API tramite MCP, aggiorna l’argomento model:

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.
Se chiami l’API tramite MCP, aggiorna l’argomento model:

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

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:
Per i client MCP, ispeziona il campo deprecation su ciascun modello restituito da list_models e get_model_schema.