Descontinuações

Visão geral

Quando um modelo na Krea API é descontinuado, comunicamo-lo através de três canais para que a sua integração possa reagir automaticamente:

Cabeçalhos HTTP em todas as respostas bem-sucedidas de um endpoint descontinuado:
- Deprecation: true
- Sunset: Mon, 27 Apr 2026 00:00:00 GMT — quando o endpoint deixará de aceitar pedidos (data em formato RFC 1123)
- Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — aponta para a entrada nesta página
OpenAPI: a operação é marcada com deprecated: true e a descrição começa com um bloco de aviso.
MCP list_models: os modelos descontinuados incluem um objeto deprecation junto ao seu esquema.

Após a data de fim de vida, o endpoint devolve 410 Gone com um corpo estruturado:

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

O campo error é estável e seguro para usar em ramificações. Os campos replacement e migration_url estão presentes quando existe uma substituição recomendada.

O fim de vida é aplicado no servidor no momento em que a data é ultrapassada. O seu código deve tratar qualquer 410 de um endpoint de modelo como terminal — tentar novamente não ajudará.

Atualmente em fim de vida

seedream3

Fim de vida em 2026-05-13. O modelo foi descontinuado pela ByteDance. Migração: mude o caminho do seu pedido de image/bytedance/seedream-3 para image/bytedance/seedream-5-lite.

- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite

Se chamar a API via MCP, atualize o argumento model:

- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

seedance-1-0-lite

Fim de vida em 2026-04-27. O fornecedor descontinuou este modelo. Migração: mude o caminho do seu pedido de video/bytedance/seedance-1.0-lite para video/bytedance/seedance-1.0-pro-fast. Os formatos de pedido e resposta são, de resto, compatíveis.

- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast

Se chamar a API via MCP, atualize o argumento model:

- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

sora-2

Fim de vida em 2026-04-27. O fornecedor descontinuou este modelo. Não existe uma substituição direta no momento. Se estava a usar video/openai/sora-2, avalie outros modelos de texto-para-vídeo no nosso catálogo de Vídeo — video/google/veo-3.1, video/runway/gen-4.5 e video/bytedance/seedance-1.0-pro são as opções mais próximas para clipes curtos de alta qualidade.

- POST /generate/video/openai/sora-2
+ POST /generate/video/<substituicao-escolhida>

Como detetar descontinuações no seu código

Se quiser detetar descontinuações antes do fim de vida em vez de reagir a 410, procure o cabeçalho Deprecation: true em qualquer resposta e apresente-o nos seus registos ou alertas. Um exemplo mínimo:

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

Para clientes MCP, inspecione o campo deprecation em cada modelo devolvido por list_models e get_model_schema.

Overview

Creative Tools

AI Models

Descontinuações

Visão geral

Atualmente em fim de vida

seedream3

seedance-1-0-lite

sora-2

Como detetar descontinuações no seu código

​Visão geral

​Atualmente em fim de vida

​seedream3

​seedance-1-0-lite

​sora-2

​Como detetar descontinuações no seu código

Visão geral

Atualmente em fim de vida

seedream3

seedance-1-0-lite

sora-2

Como detetar descontinuações no seu código