> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deprecaciones

> Consulta los modelos y endpoints de la API de Krea que están en desuso o programados para su retirada, con recomendaciones de reemplazo y guías de migración para cada uno.

## 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:

```json theme={null}
{
	"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.

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

## 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`**.

```diff theme={null}
- POST /generate/image/bytedance/seedream-3
+ POST /generate/image/bytedance/seedream-5-lite
```

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

```diff theme={null}
- { "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.

```diff theme={null}
- 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`:

```diff theme={null}
- { "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](/developers/examples/text-to-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.

```diff theme={null}
- 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:

```javascript theme={null}
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`.