API · Referencia
API de Seedance 2.5: slugs, parámetros y precios
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.
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 |
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.
Para generar un vídeo sin la API, abra la página de Seedance 2.5: aparece en el catálogo de Clipia solo cuando ambos modos están activos.
Comprobar la disponibilidad
curl -s https://api.clipia.ai/v1/models \
-H "Authorization: Bearer $CLIPIA_KEY" \
| jq '.data[] | select((.slug // "") | startswith("seedance-2-5"))'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");
}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")Los modelos LLM de la misma lista no tienen slug, por eso los ejemplos lo comprueban: consulte Catálogo de modelos.
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
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. El coste depende de la duración y la resolución; el audio no lo cambia.
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.
Enviar texto a vídeo
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.
Catálogo de modelos
GET /v1/models — los modelos de imagen, vídeo y audio de Clipia con slugs exactos, esquema de entrada y precios, incluidos los slugs que contienen una barra.
Estimación del coste
POST /v1/models/{model}/estimate — averigüe cuánto cuesta una generación en créditos antes de ejecutarla; no se crea ningún trabajo ni se reservan créditos.