Descontinuações

Visão geral

Quando um modelo na Krea API é descontinuado, comunicamos isso por três canais para que sua integração possa reagir automaticamente:

Cabeçalhos HTTP em toda resposta bem-sucedida de um endpoint descontinuado:
- Deprecation: true
- Sunset: Mon, 27 Apr 2026 00:00:00 GMT — quando o endpoint deixará de aceitar requisições (data no 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 está marcada como deprecated: true e a descrição começa com um bloco de aviso.
list_models do MCP: modelos descontinuados incluem um objeto deprecation junto ao seu schema.

Após a data de encerramento, o endpoint retorna 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 pode ser usado com segurança em uma estrutura de decisão. Os campos replacement e migration_url estão presentes quando existe uma substituição recomendada.

O encerramento é aplicado no lado do servidor no momento em que a data é ultrapassada. Seu código deve tratar qualquer 410 de um endpoint de modelo como terminal — tentar novamente não vai ajudar.

Atualmente encerrados

seedream3

Encerrado em 2026-05-13. O modelo foi descontinuado pela ByteDance. Migração: altere o caminho da requisição 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 você chama 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

Encerrado em 2026-04-27. O provedor descontinuou este modelo. Migração: altere o caminho da requisição de video/bytedance/seedance-1.0-lite para video/bytedance/seedance-1.0-pro-fast. Os formatos de requisição e resposta são, em outros aspectos, compatíveis.

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

Se você chama 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

Encerrado em 2026-04-27. O provedor descontinuou este modelo. No momento não há substituição direta. Se você usava video/openai/sora-2, avalie outros modelos de texto para vídeo em 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/<chosen-replacement>

Como detectar a descontinuação no seu código

Se você quiser identificar descontinuações antes do encerramento em vez de reagir ao 410, monitore o cabeçalho Deprecation: true em qualquer resposta e exponha-o nos seus logs 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 retornado por list_models e get_model_schema.

Overview

Creative Tools

AI Models

Descontinuações

Visão geral

Atualmente encerrados

seedream3

seedance-1-0-lite

sora-2

Como detectar a descontinuação no seu código

​Visão geral

​Atualmente encerrados

​seedream3

​seedance-1-0-lite

​sora-2

​Como detectar a descontinuação no seu código

Visão geral

Atualmente encerrados

seedream3

seedance-1-0-lite

sora-2

Como detectar a descontinuação no seu código