Guía de uso
Flujo de trabajo de video corto con imagen a video de Wan2.7 mediante la API de HiAPI
Guía para desarrolladores: selección del fotograma inicial, prompts de plano y ritmo, relación de aspecto, duración y generación en lote
En esta página
Por qué la imagen a video encaja en la producción de video corto
El video corto es un negocio que gana por volumen. Un clip individual rara vez es el entregable final; el entregable real es una serie de clips que comparten la misma apariencia, el mismo ritmo y la misma frecuencia de publicación. Esta necesidad moldea la elección de herramientas más que cualquier métrica de calidad de salida individual.
La imagen a video encaja muy bien aquí porque convierte el fotograma estático en la señal de control principal. En lugar de describir con palabras toda la escena y esperar que el modelo caiga justo en la composición que imaginaste, entregas al modelo un fotograma ya aprobado: el sujeto está donde lo colocaste, el encuadre es el que diseñaste y la luz cae tal como la dispusiste. El paso de generación se centra entonces en el movimiento — cómo se mueve el sujeto, cómo se mueve la cámara, con qué rapidez respira la toma — en lugar de crear una escena desde cero.
Esta división del trabajo importa para los equipos. El fotograma estático puede producirlo, revisarlo y aprobarlo alguien con buen ojo para la composición, usando cualquier canalización que ya tengas. El movimiento es un problema más pequeño y más fácil de probar. Cuando un clip sale mal, normalmente puedes determinar si el problema está en el fotograma o en el prompt, y ese es exactamente el tipo de bisección que quieres cuando produces decenas de clips por semana.
La canalización de extremo a extremo en HiAPI se mantiene deliberadamente aburrida:
- Crear o elegir un fotograma inicial estático para cada plano.
- Redactar un prompt de plano que describa la acción del sujeto, el movimiento de cámara y el ritmo.
- Enviar el fotograma estático y el prompt, junto con una relación de aspecto y una duración fijas, a la ruta
wan2.7-video/image-to-video. - Recopilar los clips devueltos en una cola de revisión.
- Aceptar, volver a promptear o reencuadrar, y luego publicar.
Toda esta guía trata de hacer reproducible cada uno de esos pasos, porque el valor de una canalización de video corto no está en un clip brillante — está en poder ejecutar el mismo proceso mañana con nuevos fotogramas y obtener resultados comparables.
El fotograma estático como unidad de trabajo
Trata el fotograma estático como un artefacto que versionas. En la práctica, esto significa nombrar los fotogramas de forma determinista y guardar los fotogramas aprobados junto con los prompts que se usan con ellos. Si más adelante quieres probar una variante diferente del mismo plano, cambia una sola variable a la vez: el prompt o el fotograma, nunca ambos.
Qué decide el modelo y qué no
La relación de aspecto y la duración las decides tú, no son propiedades que surjan espontáneamente del prompt. Fíjalas desde el principio. Todo lo que viene después — cómo encuadras el fotograma estático, cómo formulas el ritmo, cómo editas el clip para la plataforma — asume que esos dos valores ya están fijados.

Elegir el fotograma inicial
El fotograma inicial hace la mayor parte del trabajo. Si eliges mal el fotograma inicial, ninguna cantidad de ajuste del prompt podrá salvar del todo el clip, y pasarás muchas rondas de iteración persiguiendo un problema que en realidad está en el fotograma estático. Filtra los fotogramas candidatos con una lista de verificación breve y explícita antes de gastar una sola generación.
Composición y recorte del sujeto
El fotograma que elijas debe estar compuesto para la relación de aspecto que vas a entregar, no solo recortado a esa proporción. Si el sujeto está cerca del borde del fotograma estático, espera que el modelo tenga poco espacio para mover la cámara sin sacar al sujeto de cuadro. Deja espacio para que ocurra el movimiento: espacio de mirada en la dirección del paneo previsto, espacio por encima de un sujeto que podría elevarse, elementos en primer plano que puedan producir paralaje.
Comprueba el recorte en la relación de aspecto de entrega, no en la de origen. Un fotograma que se ve equilibrado como cuadrado puede perder al sujeto cuando se comprime en un fotograma vertical alto.
Espacio de cabeza y consistencia del encuadre
Si una serie de clips se va a montar junta o a publicar en secuencia, mantén el espacio de cabeza consistente entre fotogramas. Un espacio de cabeza inconsistente se lee como un montaje descuidado, incluso si cada clip individual está bien. Establece una convención — por ejemplo, una distancia fija desde la parte superior de la cabeza del sujeto hasta el borde superior del cuadro — y aplícala a cada fotograma estático del grupo.
Estabilidad de la dirección de la luz y las sombras
La iluminación determina cuán creíble se ve el movimiento. Una luz fuerte y direccional con sombras claras da al modelo una estructura a la que aferrarse; una luz plana y sin sombras suele producir un movimiento que parece deslizarse en lugar de moverse. Prefiere fotogramas con una dirección de luz inequívoca y evita fotogramas estáticos donde las sombras podrían caer en dos direcciones — esa ambigüedad suele manifestarse como parpadeo.
Una quietud que apunte al movimiento
Un buen fotograma inicial sugiere lo que ocurre a continuación. Un sujeto en medio de una acción, una mirada hacia fuera del cuadro, un cuerpo inclinado hacia un espacio abierto — todo esto da al modelo una dirección natural de continuación. Un retrato perfectamente simétrico, de frente y estático es lo más difícil de animar de forma natural, porque no tiene una dirección implícita.
Limpieza del fotograma
Antes de generar, revisa el fotograma estático a resolución completa en busca de defectos: estelas en los bordes, manos inconsistentes, texturas repetidas, texto que se distorsionará de forma evidente en cuanto empiece el movimiento. Un defecto pequeño en el fotograma estático se convierte en un defecto evidente en el clip. Arreglar o regenerar el fotograma casi siempre es más barato que volver a extraer el video.

Redactar prompts de plano y ritmo
El error de prompt más común en imagen a video es escribir el prompt como una descripción de escena. La escena ya está decidida — es el fotograma. Lo que el modelo necesita de ti son instrucciones de plano: qué se mueve, cómo se mueve y con qué rapidez.
Estructurar el prompt en tres cláusulas
Los prompts que producen de forma consistente clips utilizables suelen cubrir tres cosas en orden:
- Acción del sujeto — qué hace el sujeto, con una descripción física concreta.
- Movimiento de cámara — qué hace la cámara, como un único movimiento limpio.
- Ritmo — a qué velocidad se desarrolla la acción a lo largo del clip.
Por ejemplo, en lugar de describir a una persona en una habitación, describe que el sujeto gira la cabeza hacia la ventana, que la cámara se acerca lentamente y que la acción se desarrolla gradualmente a lo largo de toda la duración. Cada cláusula corresponde a algo que el modelo puede ejecutar.
Mantener un único movimiento de cámara
Un solo movimiento por plano. Acercamiento, paneo o deriva de cámara en mano — elige uno. Los prompts que piden un acercamiento junto con una órbita y un zoom suelen producir un movimiento turbio e indeterminado. Si un plano necesita dos movimientos, son dos planos.
Ritmo según la plataforma, no según el modelo
El público del video corto desliza rápido. Un clip que dedica la mayor parte de su duración a establecer una escena estática pierde a la audiencia antes de que ocurra algo. Escribe el ritmo de forma explícita: adelanta algo de movimiento en los primeros instantes y luego deja que el plano se estabilice en la acción principal. Las palabras que transmiten velocidad — gradualmente, ágilmente, sostenido, estabilizándose — son más útiles que una larga lista de adjetivos.
Describe movimiento, no emoción
Las palabras emocionales son baratas y en su mayoría se ignoran. Las descripciones físicas no. Prefiere afirmaciones observables sobre cuerpos, objetos y cámara en lugar de rasgos abstractos. Si quieres una sensación emocional concreta, consíguela a partir de la acción y el ritmo, no de palabras como «cinematográfico».
Versionar los prompts como si fuera código
Guarda cada prompt junto con el identificador del fotograma, la relación de aspecto y la duración en un repositorio de código o una base de datos. Cuando un clip funcione bien, querrás saber qué combinación lo produjo, para poder volver a ejecutar esa combinación sobre un lote de fotogramas similares más adelante.
Configurar relación de aspecto y duración
La relación de aspecto y la duración son los dos parámetros con más probabilidades de sabotear silenciosamente el flujo de trabajo, porque ninguno aparece en el prompt y ambos cambian qué cuenta como buen resultado. Decídelos una vez por formato de salida y trátalos como constantes.
Elegir la relación de aspecto
Elige la proporción que tu plataforma de destino muestra realmente y compón tus fotogramas estáticos para ella. La consecuencia práctica: no deberías reutilizar el mismo fotograma entre vertical y horizontal sin recomponer — un recorte que funciona en alto rara vez funciona en ancho. Si necesitas ambos, mantén dos conjuntos de fotogramas estáticos derivados de la misma toma, cada uno compuesto para su propia proporción.
Una vez elegida, registra esa proporción con cada solicitud. Una proporción mezclada dentro de un lote terminado normalmente significa que alguien cambió el valor predeterminado, no que tomó una decisión.
Elegir la duración
Los clips de video corto son cortos. Planifica una duración que coincida con el formato: lo bastante larga para completar una única acción clara y lo bastante corta para que no haya nada ocioso. Como HiAPI cobra la imagen a video según la duración de salida, los clips demasiado largos cuestan más y se revisan peor — el público rara vez llega al final de un clip que ya no tiene nada que decir.
Escribe el prompt para llenar la duración que elijas. Una acción descrita más larga que el clip produce un corte abrupto a mitad de movimiento; una acción que termina en una fracción de la duración deja un vacío al final. Haz que la formulación del ritmo coincida deliberadamente con la longitud.
Fijar ambos antes de escalar
Esta es la regla de proceso más importante de la guía. El ajuste de prompts solo tiene sentido dentro de una relación de aspecto y una duración fijas, porque ambas cambian la forma en que se percibe el movimiento. Si ajustas los prompts con una duración y luego acortas la salida, cada prompt que aprobaste se convierte en una suposición no probada. Bloquea ese par de parámetros, ajusta contra él y cámbialo solo como un evento deliberado de reajuste.
Parámetros que vale la pena registrar en cada ejecución
Mantén un pequeño registro por lote: relación de aspecto, duración, ruta del modelo, identificador del grupo de fotogramas, versión del prompt. Ese registro de cuatro campos suele ser suficiente para reconstruir meses después por qué un clip se veía como se veía, sin tener que hurgar en los registros.
Generar en lote en HiAPI
Una vez aprobados el grupo de fotogramas y el patrón de prompts, la generación es mecánica. El objetivo es un script pequeño que despliegue las solicitudes y recopile los resultados de forma determinista, para poder ejecutarlo según un calendario en lugar de a mano.
Credenciales y configuración
Guarda las credenciales de la API en variables de entorno, nunca en un script ni en un repositorio. Lee el endpoint y la ruta del modelo desde la configuración, para que más adelante puedas apuntar el mismo script a una ruta diferente sin modificar la ruta del código.
export HIAPI_API_KEY="your-key-here"
Una solicitud ejecutable
La ruta de este flujo de trabajo es wan2.7-video/image-to-video. La solicitud mínima incluye el fotograma inicial, el prompt de plano, la relación de aspecto y la duración:
curl -X POST "https://api.hiapi.ai/v1/video/generations" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-video/image-to-video",
"image": "https://your-cdn.example/frames/shot-014.png",
"prompt": "Subject turns toward the window; slow push-in; gradual motion settling over the clip.",
"aspect_ratio": "9:16",
"duration": 5
}'
Ejecuta una vez contra un fotograma que sepas que es bueno antes de poner nada en un bucle. Una sola solicitud exitosa confirma tus credenciales, el nombre de la ruta y la estructura del payload de la solicitud.
Recorrer un conjunto de fotogramas
La generación en lote es la misma solicitud repetida, solo que con un image y un prompt asociado diferentes. Organiza la entrada como una lista de registros, donde cada registro lleva la URL del fotograma, su prompt y un nombre de salida que tú controles. Itera, envía y registra los identificadores devueltos en el registro de entrada.
Dos reglas prácticas para el bucle:
- Limita la concurrencia. Enviar todas las solicitudes a la vez es la forma más rápida de chocar contra los límites de tasa y de perder de vista qué respuesta pertenece a qué entrada. Un grupo de trabajo moderado con reintentos es más fiable que una ráfaga.
- Registra la solicitud junto con el resultado. Para cada generación, guarda de forma persistente la URL del fotograma, el prompt, la relación de aspecto, la duración y la referencia del clip devuelto. Sin eso, no puedes reproducir un buen clip ni explicar uno malo.
Recopilar las salidas
Descarga los clips en una estructura de carpetas determinista, con claves basadas en el identificador del fotograma y la versión del prompt, y luego entrega la carpeta para revisión. Mantener un esquema de nombres estable significa que tu paso de revisión es simplemente listar un directorio, no una tarea de conciliación.
Idempotencia en las reejecuciones
Asigna un hash estable a cada par fotograma-prompt y omite los pares que ya se generaron, a menos que estés volviendo a extraer de forma deliberada. Regenerar todo el lote para cubrir tres huecos es la forma más común en que los equipos desperdician cuota en una canalización de imagen a video.

Revisar e iterar las salidas
La revisión es un paso de producción, no una formalidad. El objetivo es clasificar rápidamente cada clip en uno de tres resultados — aceptar, volver a promptear o reencuadrar — para que el lote siga avanzando.
Una lista de verificación breve para la revisión
Haz que cada clip devuelto pase por las mismas comprobaciones, en orden:
- Fidelidad al fotograma inicial — ¿el instante de apertura coincide con el fotograma estático que aprobaste? Si se desvía de inmediato, el problema suele estar en el fotograma, no en el prompt.
- Plausibilidad del movimiento — ¿el sujeto se mueve como se mueven realmente los cuerpos y los objetos? Busca deslizamientos, deformaciones de extremidades y objetos que cambian de forma.
- Disciplina de cámara — ¿la cámara ejecuta el único movimiento que pediste, o va a la deriva?
- Encaje del ritmo — ¿la acción se completa dentro de la duración, sin una cola sobrante ni un corte a mitad de movimiento?
- Barrido de defectos — revisa bordes, manos, rostros, texto de fondo y cualquier zona de detalle fino.
- Comprobación de formato — ¿la relación de aspecto es correcta y el sujeto queda dentro de los márgenes seguros de las superposiciones de UI de la plataforma?
Decisiones de clasificación
- Aceptar si el clip pasa las seis comprobaciones, o solo falla en aspectos invisibles a la resolución de entrega.
- Volver a promptear si el fotograma es bueno pero el movimiento, la cámara o el ritmo están mal. Modifica una cláusula del prompt y regenera.
- Reencuadrar si los defectos de movimiento se remontan a una ambigüedad del fotograma estático — una dirección de luz poco clara, un recorte incómodo o un sujeto sin movimiento implícito.
Cambia una sola variable en cada iteración. Cambiar el fotograma y el prompt a la vez no te dice cuál de las correcciones funcionó.
Una revisión barata supera a un plano perfecto
Para la producción en volumen de video corto, una revisión rápida de aprobado/no aprobado sobre muchos clips supera a pulir un único clip mediante muchas extracciones. Revisa al tamaño al que el público verá realmente el clip, no a resolución completa, y amplía solo los clips que estés a punto de aceptar. Esto mantiene el paso de revisión proporcional al tamaño del lote, no a tu ansiedad.
Realimentar los hallazgos
Registra de forma continua qué patrones de prompt y calidades de fotograma se correlacionan con las tasas de aceptación. Tras unos cuantos lotes, esto se convierte en un estilo interno — un conjunto breve de cláusulas de prompt y reglas de encuadre que producen de forma consistente clips que los revisores aprueban sin largas discusiones.
Errores que evitar
La mayoría de los proyectos de imagen a video que se estancan en producción fallan por problemas de proceso, no por problemas del modelo. Estos son los que se repiten.
Ajustar prompts contra un objetivo móvil
Cambiar la duración o la relación de aspecto a mitad del ajuste invalida todas las comparaciones que hiciste. Fija ambos primero, luego ajusta. Si las partes interesadas piden un formato diferente, trátalo como un nuevo ciclo de ajuste con sus propios prompts aprobados, no como un retoque de parámetros.
Tratar el fotograma estático como una ocurrencia tardía
Los equipos que generan un fotograma rápidamente y dedican todo el esfuerzo al prompt llegan pronto a su techo. El fotograma es la señal de control. Reserva tiempo real de revisión para los fotogramas estáticos y rechaza los débiles antes de que entren en la generación.
Usar descripciones de escena en lugar de instrucciones de plano
Los prompts llenos de emoción y trasfondo, pero sin acción física, producen clips bonitos en los que no ocurre nada. Cada prompt debe indicar qué se mueve y con qué rapidez.
Concurrencia sin límites y registros ausentes
Enviar solicitudes en ráfaga y descartar los identificadores de respuesta deja el lote irrecuperable. Registra la entrada y la salida juntas, limita el número de hilos de trabajo y haz que las reejecuciones sean idempotentes.
Sin registro de aprobaciones
Si no puedes señalar el fotograma, el prompt, la proporción y la duración exactos que produjeron un clip aceptado, no puedes repetirlo. El coste aparece la primera vez que necesitas escalar una serie y te das cuenta de que el mejor clip no se puede reproducir.
Generar en exceso para cubrir pequeños huecos
Volver a ejecutar todo el lote porque tres clips fallaron desperdicia tiempo y presupuesto. Lleva el estado de cada elemento y regenera solo las partes que faltan.
Ignorar las zonas seguras de la plataforma
Un clip técnicamente correcto pero con el sujeto bajo una superposición de UI de la plataforma se lee como roto. Compón los fotogramas estáticos con los mismos márgenes seguros que usarías para cualquier otro recurso que entregues.
Nada de esto es exótico. Es simplemente la disciplina habitual de una canalización de producción, aplicada a un modelo que recompensa esa disciplina.
Empieza con un fotograma aprobado y un prompt, ejecútalo de extremo a extremo en la ruta wan2.7-video/image-to-video y luego amplía el bucle hasta el lote completo.
Artículos relacionados
Ver todos los artículos →-
Guía de uso
Guía de inicio con gpt-6.2-sol: límites de capacidad, integración vía API y consideraciones sobre el precio por token
Puntos clave de decisión e implementación de la integración para equipos de ingeniería
-
Guía de uso
Guía de inicio de gpt-6.2-astra: límites de capacidad del modelo de texto, puntos clave de integración y control de costes
-
Guía de uso
Guía de inicio de Tripo H3.1: cómo elegir entre tres modos de entrada, parámetros y precios
Guía práctica de decisiones de integración y control de costes de la generación 3D para desarrolladores