Video

Genera video a partir de texto o de una imagen. La plataforma ofrece dos motores: fal es el principal (muchos modelos), y Higgsfield es una opción de imagen a video estilo DoP.

Qué puedes hacer

Tres formas de generar video:

• Texto → video (t2v) — describe una escena, obtén un clip.
• Imagen → video (i2v) — anima una imagen estática.
• Primer fotograma → último fotograma — interpola el movimiento entre dos imágenes estáticas.

Algunos modelos también admiten referencia a video, extender/continuar y editar. Los modos disponibles dependen del modelo que elijas:

Cómo elegir un modelo

fal_generate_video es el caballo de batalla: un solo punto de entrada a muchos modelos de primer nivel. Elige un modelo con model_id, y pasa los parámetros de ese modelo en input. Cada familia admite modos y campos distintos:

higgsfield_generate_video — imagen a video estilo DoP. Modelos: higgsfield-ai/dop/lite / dop/standard / dop/turbo (cada uno con una variante /first-last-frame). No tiene texto a video puro — para texto → video, teje una imagen primero (ver más abajo).

Interfaz

fal_generate_video — envía un trabajo. Entradas: model_id (un endpoint id) e input (el objeto de parámetros completo de ese modelo, pasado tal cual). Devuelve un request_id.

fal_get_video_status — consulta el estado de un trabajo. Pasa ambos, model_id y request_id. Devuelve IN_QUEUE / IN_PROGRESS, o COMPLETED con la URL del video.

higgsfield_generate_video — envía. Entradas: prompt, image_url (obligatorio), model_id, params (específico del modelo, pasado tal cual). Devuelve un request_id.

higgsfield_get_video_status — consulta el estado. Pasa solo request_id. Devuelve in_progress, completed (con la URL del video), o failed / nsfw.

Cómo usarlo en un Skill

La generación de video es asíncrona — dos pasos:

1. Envía con *_generate_video → obtén un request_id.
2. Consulta *_get_video_status hasta que esté COMPLETED → obtén la URL del video.

La generación puede tardar unos minutos — sigue consultando hasta que termine. Para fal, pasa ambos, model_id y request_id, al consultar; para Higgsfield, solo request_id.

Texto → video en un motor que solo admite imagen a video (o siempre que quieras un encuadre dirigido artísticamente): genera primero una imagen, y luego pásala como el fotograma inicial.

# Texto → video (Veo 3.1, con audio, 8 segundos)
fal_generate_video(
  model_id="fal-ai/veo3.1",
  input={ "prompt": "A cinematic drone shot over a misty mountain lake at dawn",
          "duration": "8s", "resolution": "1080p", "generate_audio": true }
)

# Imagen → video (Kling — nota que es start_image_url, no image_url)
fal_generate_video(
  model_id="fal-ai/kling-video/v3/pro/image-to-video",
  input={ "prompt": "the character slowly turns and smiles",
          "start_image_url": "https://…", "duration": "5" }
)

Tejido para imagen → video:

1. google_generate_image / openai_generate_image(prompt)        → imagen
2. fal_generate_video(model_id=".../image-to-video",
     input={ prompt: movimiento, image_url: <imagen> })          → request_id
   (o higgsfield_generate_video, con image_url)
3. consulta *_get_video_status hasta COMPLETED                   → URL del video