Deprecaciones

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

Programados para retirada

krea-3-thinking-mode-values

Retirada el 2026-10-30. Los valores heredados de thinking_mode de Krea 3 (image/krea/krea-3) cambian de nombre. Hasta la fecha de retirada, los valores antiguos siguen funcionando y la respuesta incluye los encabezados de deprecación. Después de la fecha de retirada, se rechazan las solicitudes con un valor antiguo. Migración: envía el nuevo valor.

Valor antiguo	Valor nuevo
`instant`	`fast`
`medium`	`high`
`max`	`ultra`

- { "prompt": "...", "thinking_mode": "instant" }
+ { "prompt": "...", "thinking_mode": "fast" }

Consulta Modos de razonamiento de Krea 3.

Actualmente retirados

gpt-image

Retirado el 2026-10-23. OpenAI dio de baja gpt-image-1, el modelo detrás de image/openai/gpt-image. Migración: cambia la ruta de la solicitud de image/openai/gpt-image a image/openai/gpt-image-2. prompt, quality e imageUrls se mantienen; gpt-image-2 no acepta presetStyles.

- POST /generate/image/openai/gpt-image
+ POST /generate/image/openai/gpt-image-2

Si llamas a la API mediante MCP, actualiza el argumento model:

- { "model": "image/openai/gpt-image", "input": { ... } }
+ { "model": "image/openai/gpt-image-2", "input": { ... } }

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.

Primeros pasos

Seedance

Krea 3

Krea 2

Conceptos básicos

Ejemplos de código

Tutoriales

Deprecaciones

Descripción general

Programados para retirada

krea-3-thinking-mode-values

Actualmente retirados

gpt-image

seedream3

seedance-1-0-lite

sora-2

Cómo detectar deprecaciones en tu código