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
- 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:
480po720p, por defecto480p. - 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 defectoadaptive(el modelo elige la proporción según el prompt). - output_format:
mp4(por defecto) omov. - 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
- 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.
- 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.
- 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.
- 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 →-
Guía de uso
Guía de integración de Seedance 2.5 Flash para generar video a partir de materiales de referencia: imágenes de referencia, audio de referencia y reglas de facturación
-
Guía de uso
Guía de integración de Seedance 2.5 Flash para imagen a video: primer fotograma, último fotograma y facturación por segundo
Hacer que una imagen se mueva: parámetros, precios y causas habituales de fallo
-
Guía de uso
Guía de inicio de kling-image-4.0: puntos clave de integración de la API de generación de imágenes y control de costes
Decisiones de integración y lista de verificación práctica para desarrolladores