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
- Modelo
- seedance-2.5-flash
En esta página
Qué hace este modelo
seedance-2.5-flash/image-to-video es un modelo de imagen a video de ByteDance: se sube una imagen como primer fotograma, el modelo la toma como punto de partida para generar un video continuo y, de forma sincronizada, genera audio. La relación de aspecto de la imagen sigue al primer fotograma, sin recorte secundario.
Es adecuado para escenarios que parten de material determinista: presentación dinámica de imágenes de producto, microexpresiones y movimiento corporal de ilustraciones de personajes, previsualización dinámica de bocetos de storyboard y clips cortos que necesitan llenar un banco de contenido por lotes. No es adecuado para necesidades de «generar una narrativa completa solo con una frase»; eso es tarea de la línea de texto a video.
Parámetros de la solicitud
- prompt (obligatorio): describe la acción, el movimiento de cámara, la escena y el sonido deseados, con un máximo de 5000 caracteres.
- first_frame_url (obligatorio): imagen del primer fotograma. Admite jpeg, png, webp, bmp, tiff, gif, heic, heif, con un máximo de 30 MB por imagen, de 300 a 6000 píxeles por lado y una relación de aspecto de 0.4 a 2.5.
- last_frame_url (opcional): imagen del último fotograma, con las mismas restricciones que el primer fotograma; si las proporciones no coinciden, se recorta centrada para alinearla. Si se envía el último fotograma, también se debe enviar el primer fotograma.
- resolution:
480po720p, por defecto480p. - duration: entero de 4 a 30, por defecto 5, en segundos.
- aspect_ratio: solo acepta
adaptive; la proporción de salida sigue a la imagen del primer fotograma. - output_format:
mp4(por defecto) omov. - generate_audio: por defecto
true.
Facturación por segundo
- 480p: $0.0679/segundo
- 720p: $0.1525/segundo
Los segundos facturados equivalen a la duración solicitada. Algunos niveles habituales: 480p 4 segundos $0.2716, 720p 4 segundos $0.61, 480p 10 segundos $0.679, 720p 10 segundos $1.525. Las imágenes del primer y último fotograma no se cobran aparte.
Como la facturación es por segundo, reintentar implica pagar de nuevo. Evaluar «si el primer fotograma es adecuado» antes de enviar la solicitud sale mucho más barato que regenerar después.
El primer fotograma marca el límite del resultado
El modelo solo puede extender la información que ya existe en el primer fotograma, por lo que la calidad de este determina casi por completo el límite del resultado:
- El sujeto debe ser claro y ocupar una proporción razonable del encuadre; si es demasiado pequeño, al modelo le cuesta decidir qué debe moverse.
- Evita desenfoques fuertes y ruido; una entrada de baja calidad se amplifica en cada fotograma.
- Cuida los bordes del encuadre: los sujetos cortados tienden a deformarse al moverse.
- El texto dentro de la imagen difícilmente se mantiene estable en movimiento, salvo que no sea lo importante.
- Preparar varias imágenes candidatas del mismo sujeto como primer fotograma es más eficaz que ajustar repetidamente el prompt.
La duración es tanto coste como variable de calidad
Cuanto más largo es el clip, más fotogramas necesita el modelo para mantener la coherencia y mayor es la probabilidad acumulada de deriva y distorsión. Se recomienda validar primero con 4 a 5 segundos si el primer fotograma y la dirección del movimiento funcionan, y alargar después según sea necesario; para contenido largo, organiza «varios clips cortos + montaje posterior» en lugar de depender de una única generación larga.
Fallos habituales y orden de diagnóstico
- Error de parámetros al enviar: comprueba primero si la imagen supera los límites (tamaño, longitud de lado, relación de aspecto, formato) y si solo se envió
last_frame_urlsin el primer fotograma. - Deformación del sujeto: suele deberse a un sujeto demasiado pequeño en el primer fotograma, bordes cortados o una exigencia de movimiento excesiva. Cambia el primer fotograma o describe una acción más leve.
- Proporción distinta de la esperada: esta línea fija
adaptivey la salida sigue al primer fotograma; si quieres 16:9 o 9:16, defínelo en el primer fotograma. - Contenido bloqueado: el primer fotograma también pasa por revisión de cumplimiento; lo que aparezca en la imagen determina directamente si la llamada es válida.
- El cliente agota el tiempo de espera pero la tarea en realidad tuvo éxito: la generación de video tarda bastante; un timeout del cliente demasiado corto hace pasar un éxito por fallo, y reenviar vuelve a facturar. Trátalo como tarea asíncrona y concede un timeout suficiente.
Recomendaciones para el despliegue
Primero recorre el flujo completo con tres a cinco primeros fotogramas de distintos tipos, verificando que envío, sondeo y descarga funcionan; después fija el primer fotograma y cambia solo el prompt para identificar qué descripciones de acción responde bien el modelo; por último, escala proporcionalmente vigilando la tasa de éxito, el tiempo medio y la tasa de reintentos. Los parámetros y precios están sujetos a la descripción actual de la página del modelo.
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 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
-
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