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 generateimage_url(string): URL of the input image to animate (usefal_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