HiAPI
Blog

Guía de uso

Guía de integración de texto a vídeo de Seedance 2.5 Flash: parámetros, facturación por segundo y prácticas de ingeniería

De una solicitud a la puesta en producción estable: cómo configurar los parámetros y cómo calcular el coste

Nov 17, 2026
Sobre un fondo de carbón cálido, una amplia franja de luz ámbar cruza en diagonal, con bordes nítidos y un conjunto sobrio con espacio en blanco.
Modelo
seedance-2.5-flash
En esta página

Qué hace este modelo

seedance-2.5-flash/text-to-video es el modelo de texto a vídeo de ByteDance: recibe un prompt de texto y devuelve un vídeo con audio sincronizado. Solo tiene esta vía de entrada: no acepta imágenes ni vídeos como entrada condicional, ni realiza comprensión de vídeo.

Los escenarios adecuados son «generar con una sola frase un pequeño vídeo utilizable»: producción masiva de materiales de marketing, planos vacíos y de ambiente para vídeos cortos de producto, relleno de fragmentos en un banco de contenidos y previsualización rápida de direcciones creativas. Si tu punto de partida es una imagen, la vía de imagen a vídeo es más directa; si necesitas mantener la coherencia del sujeto a partir de materiales de referencia, usa la vía impulsada por materiales de referencia.

Qué parámetros hay en la solicitud

  • prompt (obligatorio): escena, sujeto, movimiento de cámara y acciones. Máximo 5000 caracteres.
  • resolution: 480p o 720p, por defecto 480p.
  • duration: entero de 4 a 30, por defecto 5, en segundos.
  • aspect_ratio: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive, por defecto adaptive (el modelo elige la proporción según el prompt).
  • output_format: mp4 (por defecto) o mov.
  • generate_audio: por defecto true, genera diálogos, efectos de sonido y sonido de fondo sincronizados con la imagen.

Salvo prompt, todos tienen valor por defecto; la solicitud mínima solo necesita prompt. El cuerpo de la solicitud se valida de forma estricta: los campos no declarados que se envíen de más se rechazan en lugar de descartarse silenciosamente; así, los errores de la fase de integración se exponen en el momento del envío y no después de la facturación.

Cómo se factura por segundo

El criterio de facturación es «precio unitario por segundo × segundos de salida», vinculado al nivel de resolución:

  • 480p: $0.0679/segundo
  • 720p: $0.1525/segundo

Los segundos de salida toman el duration de la solicitud, sin redondeos inesperados. Por ejemplo: 480p 5 segundos son $0.3395, 720p 5 segundos son $0.7625; 480p 30 segundos son $2.037, 720p 30 segundos son $4.575. Si la duración se duplica, el coste se duplica; no hay descuentos de «cuanto más largo, más barato».

Esto implica tres cosas: primero, la estimación del presupuesto es una multiplicación: fija primero la duración de cada pieza y luego multiplícala por el número de piezas; segundo, reintentar es pagar de nuevo, así que los reintentos tras fallo deben tener un límite; tercero, no generes vídeos largos de una sola vez: divídelos en varios vídeos cortos, genéralos por separado y únelos después; así ahorras dinero y un fallo solo afecta al segmento dañado.

Forma de integración: tareas asíncronas

La generación de vídeo es una tarea que consume tiempo y la interfaz es asíncrona: tras el envío se obtiene un identificador de tarea, luego se consulta mediante sondeo o se espera la devolución de llamada para obtener el resultado y, por último, se descarga el producto y se almacena. No la envuelvas como un RPC síncrono que bloquee la solicitud del usuario.

  • Persistencia de la máquina de estados: guarda en la base de datos el identificador de tarea, el estado y los parámetros de la solicitud; no los dejes solo en la memoria del proceso: perder una tarea al reiniciar equivale a haber gastado dinero sin resultado.
  • Retroceso en el sondeo: empieza con intervalos cortos, alárgalos progresivamente y añade fluctuación aleatoria; además, fija un tiempo de espera total por tarea, y al superarlo pasa a la rama de fallo en lugar de sondear indefinidamente.
  • Clasificación de errores: los errores de parámetros y las infracciones de contenido son fallos deterministas y reintentarlos no tiene sentido; solo los errores transitorios como fluctuaciones de red o límites de tasa merecen reintentos con retroceso.
  • Idempotencia: incluye una clave única de negocio en el lado del envío para evitar que los clics repetidos del usuario generen múltiples tareas y facturación duplicada.

Cómo escribir prompts de forma estable

Escribir siguiendo cuatro bloques —«sujeto → secuencia de acciones → entorno e iluminación → cámara»— es mucho más estable que acumular una ristra de adjetivos.

Sujeto: un gato blanco sentado en el alféizar de la ventana, a contraluz
Acción: de quieto a levantar la cabeza y mirar por la ventana, la cola se balancea lentamente
Entorno e iluminación: luz cálida de la tarde, poca profundidad de campo, ambiente tranquilo en interiores
Cámara: plano medio, cámara fija, ligera sensación de cámara en mano

Tres reglas: un prompt describe solo un plano continuo, no metas cambios de múltiples escenas en una sola generación; versiona los prompts y cambia solo una variable cada vez, para poder determinar qué cambio surtió efecto; primero prueba con muestras pequeñas y luego escala, no uses el lote para validar un prompt que aún no está definido.

El formato y el lenguaje de cámara pueden describirse en lenguaje natural: el modelo no tiene un parámetro separado de «movimiento de cámara»; escribirlo en el prompt es más fiable que esperar un campo que no existe.

Ruta de puesta en producción

  1. Hacer funcionar la cadena: tres prompts que cubran escenarios típicos, confirma que el envío, el sondeo y la descarga funcionan de principio a fin; primero no mires si el resultado es bueno o no.
  2. Definir prompts y duración: fija un número reducido de prompts, compara los resultados con distintas redacciones y distintas duraciones, registra el coste de cada uno y forma una biblioteca de plantillas reutilizables.
  3. Despliegue gradual: aumenta el volumen por proporciones, observa la tasa de éxito, el tiempo medio, la tasa de reintentos y la curva de costes; añade más volumen cuando los tres primeros cumplan.
  4. Operación habitual: revisa periódicamente la biblioteca de plantillas, elimina redacciones ineficientes y vigila la tendencia de costes y los umbrales de reintento.

En la página del modelo están las descripciones de parámetros y los precios más recientes; basta con repasarlos antes de la integración.

Artículos relacionados

Ver todos los artículos →

Empieza a crear con artefactos de IA persistentes

Consigue tu API key y llama a modelos de imagen, vídeo y audio a través de una única API basada en tasks.

Leer la documentación de la API