Video from Image

Animate a single image into a dynamic video using Google DeepMind's Veo 3.1 model via fal.ai.

See references/fal-api.md for setup, Python patterns, and error handling.

API Endpoint

fal-ai/veo3.1/image-to-video

Parameters

Required

• prompt (string): Text description of the video motion and action to generate

• image_url (string): URL of the input image to animate (use fal_client.upload_file() for local files)

Optional

Parameter Type Default Options

duration

string "8s" "4s", "6s", "8s"

aspect_ratio

string "auto" "auto", "9:16", "16:9"

resolution

string "720p" "720p", "1080p"

generate_audio

boolean true Disable to save ~50% credits

CLI Script

python3 scripts/fal_generate.py
--endpoint video-from-image
--prompt "Camera slowly pans across the landscape"
--image /path/to/photo.jpg
--duration 8s
--video-resolution 1080p
--output video.mp4

Tips

• Use descriptive motion language in prompts: pan, zoom, sway, flow, drift

• Describe camera movements for cinematic effects: "slow dolly forward", "aerial pull back"

• Higher resolution (1080p) gives better quality but takes longer and costs more

• Disable audio generation (generate_audio: False ) to save credits when sound is not needed

• Ensure input image is at least 720p for best results

• Shorter duration (4s) generates faster and is good for quick previews