HiAPI
Blog

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

Nov 17, 2026
Una matriz de puntos menta sobre fondo negro, con la densidad de puntos aumentando gradualmente de izquierda a derecha.
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: 480p o 720p, por defecto 480p.
  • 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) o mov.
  • 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

  1. 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_url sin el primer fotograma.
  2. 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.
  3. Proporción distinta de la esperada: esta línea fija adaptive y la salida sigue al primer fotograma; si quieres 16:9 o 9:16, defínelo en el primer fotograma.
  4. 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.
  5. 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 →

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