Skip to main content

​
Descripción general

Cuando un modelo de la API de Krea se marca como en desuso (deprecated), lo comunicamos a través de tres canales para que tu integración pueda reaccionar automáticamente:
  • Encabezados HTTP en cada respuesta exitosa de un endpoint en desuso:
    • Deprecation: true
    • Sunset: Mon, 27 Apr 2026 00:00:00 GMT — cuándo el endpoint dejará de aceptar solicitudes (fecha en formato RFC 1123)
    • Link: <https://docs.krea.ai/developers/deprecations#seedance-1-0-lite>; rel="deprecation"; type="text/html" — apunta a la entrada de esta página
  • OpenAPI: la operación se marca como deprecated: true y la descripción comienza con un bloque de advertencia.
  • MCP list_models: los modelos en desuso incluyen un objeto deprecation junto a su schema.
Después de la fecha de retirada (sunset), el endpoint devuelve 410 Gone con un cuerpo estructurado: 
{
	"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"
}
El campo error es estable y seguro para usar en una estructura de control. Los campos replacement y migration_url están presentes cuando existe un reemplazo recomendado.
La fecha de retirada se aplica del lado del servidor en el momento en que pasa la fecha. Tu código debería tratar cualquier 410 de un endpoint de modelo como terminal — reintentar no ayudará.

​
Actualmente retirados

​
seedream3

Retirado el 2026-05-13. El modelo fue marcado como en desuso por ByteDance. Migración: cambia la ruta de la solicitud de image/bytedance/seedream-3 a image/bytedance/seedream-5-lite. 
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
Si llamas a la API mediante MCP, actualiza el argumento model: 
- { "model": "image/bytedance/seedream-3", "input": { ... } }
+ { "model": "image/bytedance/seedream-5-lite", "input": { ... } }

​
seedance-1-0-lite

Retirado el 2026-04-27. El proveedor descontinuó este modelo. Migración: cambia la ruta de la solicitud de video/bytedance/seedance-1.0-lite a video/bytedance/seedance-1.0-pro-fast. Por lo demás, las formas de solicitud y respuesta son compatibles. 
- POST /generate/video/bytedance/seedance-1.0-lite
+ POST /generate/video/bytedance/seedance-1.0-pro-fast
Si llamas a la API mediante MCP, actualiza el argumento model: 
- { "model": "video/bytedance/seedance-1.0-lite", "input": { ... } }
+ { "model": "video/bytedance/seedance-1.0-pro-fast", "input": { ... } }

​
sora-2

Retirado el 2026-04-27. El proveedor descontinuó este modelo. No existe un reemplazo directo por ahora. Si usabas video/openai/sora-2, evalúa otros modelos de texto a video en nuestro catálogo de Video — video/google/veo-3.1, video/runway/gen-4.5 y video/bytedance/seedance-1.0-pro son las opciones más cercanas para clips cortos de alta calidad. 
- POST /generate/video/openai/sora-2
+ POST /generate/video/<reemplazo-elegido>

​
Cómo detectar deprecaciones en tu código

Si quieres captar deprecaciones antes de la retirada en lugar de reaccionar a un 410, vigila el encabezado Deprecation: true en cualquier respuesta y muéstralo en tus logs o alertas. Un ejemplo 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, inspecciona el campo deprecation en cada modelo devuelto por list_models y get_model_schema.