---
title: "API de Seedance 2.5: slugs, parámetros y precios"
description: Seedance 2.5 en la API de Clipia — slugs T2V e I2V, límites de los parámetros, cómo comprobar la disponibilidad en el catálogo, estimar el precio y enviar por REST.
icon: Clapperboard
---

Seedance 2.5 es un modelo de vídeo de ByteDance. La API lo ofrece en dos modos públicos: texto a vídeo e imagen a vídeo.

| Modo | Slug de la API |
| --- | --- |
| Texto a vídeo | `seedance-2-5-t2v` |
| Imagen a vídeo | `seedance-2-5-i2v` |

<Callout type="info" title="Compruebe la disponibilidad en su entorno">
El modelo se activa por separado de las versiones del código. Use un slug solo cuando `GET /v1/models` lo devuelva para su clave de API. Mientras no aparezca en la lista, enviar una generación devuelve `404` con el código `not_found`.
</Callout>

Para generar un vídeo sin la API, abra la [página de Seedance 2.5](/es/video-models/seedance-2-5): aparece en el catálogo de Clipia solo cuando ambos modos están activos.

## Comprobar la disponibilidad

<Tabs items={['cURL', 'TypeScript', 'Python']}>
<Tab value="cURL">

```bash
curl -s https://api.clipia.ai/v1/models \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  | jq '.data[] | select((.slug // "") | startswith("seedance-2-5"))'
```

</Tab>
<Tab value="TypeScript">

```ts
const { data } = await clipia.models.list();
const seedance25 = data.filter(
  (model) => "slug" in model && model.slug?.startsWith("seedance-2-5"),
);

if (seedance25.length === 0) {
  throw new Error("Seedance 2.5 is not active in this environment");
}
```

</Tab>
<Tab value="Python">

```python
catalog = clipia.models.list()
seedance_25 = [
    model for model in catalog["data"]
    if (model.get("slug") or "").startswith("seedance-2-5")
]

if not seedance_25:
    raise RuntimeError("Seedance 2.5 is not active in this environment")
```

</Tab>
</Tabs>

Los modelos LLM de la misma lista no tienen `slug`, por eso los ejemplos lo comprueban: consulte [Catálogo de modelos](/es/docs/api-reference/models).

## Límites de los parámetros

| Parámetro | Valores |
| --- | --- |
| Prompt | hasta `30000` caracteres |
| Duración | 4–30 segundos |
| Resolución | `480p`, `720p`, `1080p` |
| Relación de aspecto | `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `21:9`, `adaptive` |
| Imágenes de referencia | hasta 30 |
| Vídeos de referencia | hasta 10 |
| Audio de referencia | hasta 10 |
| Audio nativo | activado por defecto; `generate_audio: false` devuelve un vídeo sin audio. Si la pista de audio no supera las normas de seguridad, el vídeo puede llegar sin audio |

`GET /v1/models/{slug}` devuelve los campos exactos del modo seleccionado. Considere ese esquema en vivo como la referencia válida por encima de este resumen estático.

## Obtener el esquema y el precio

```bash
curl https://api.clipia.ai/v1/models/seedance-2-5-t2v \
  -H "Authorization: Bearer $CLIPIA_KEY"
```

Antes de enviar, mande el mismo `input` a `POST /v1/models/seedance-2-5-t2v/estimate`: consulte [Estimación del coste](/es/docs/api-reference/estimate). El coste depende de la duración y la resolución; el audio no lo cambia.

<Callout type="info" title="Precios">
Los precios están vigentes a octubre de 2026. El coste exacto siempre se muestra en el botón de ejecución antes de cobrar nada.
</Callout>

## Enviar texto a vídeo

```bash
curl -X POST https://api.clipia.ai/v1/models/seedance-2-5-t2v \
  -H "Authorization: Bearer $CLIPIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "One continuous cinematic tracking shot through a storm",
      "duration": 10,
      "resolution": "1080p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'
```

Para imagen a vídeo, use `seedance-2-5-i2v` y pase la imagen en el campo que indica su `input_schema`. No copie nombres de campos de otras integraciones.

## Cambio explícito de modelo

Si Seedance 2.5 no figura en el catálogo en vivo, puede elegir explícitamente `seedance-2-fast-t2v` o `seedance-2-fast-i2v`. No cambie el modelo sin avisar cuando el usuario haya elegido la versión 2.5.
