Skip to main content
Endpoint: POST https://fal.run/fal-ai/veo3.1/image-to-video Endpoint ID: fal-ai/veo3.1/image-to-video

Try it in the Playground

Run this model interactively with your own prompts.

Quick Start

Capabilities

  • Text prompt input
  • Aspect ratio control
  • Duration control
  • Negative prompts
  • Reproducible generation (seed)
  • Image input

API Reference

Input Schema

string
required
The text prompt describing the video you want to generate
AspectRatioEnum
default:"auto"
The aspect ratio of the generated video. Only 16:9 and 9:16 are supported. Default value: "auto"Possible values: auto, 16:9, 9:16
DurationEnum
default:"8s"
The duration of the generated video. Default value: "8s"Possible values: 4s, 6s, 8s
string
A negative prompt to guide the video generation.
ResolutionEnum
default:"720p"
The resolution of the generated video. Default value: "720p"Possible values: 720p, 1080p, 4k
boolean
default:"true"
Whether to generate audio for the video. Default value: true
integer
The seed for the random number generator.
boolean
default:"false"
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them.
SafetyToleranceEnum
default:"4"
The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. Default value: "4"Possible values: 1, 2, 3, 4, 5, 6
string
required
URL of the input image to animate. Should be 720p or higher resolution in 16:9 or 9:16 aspect ratio. If the image is not in 16:9 or 9:16 aspect ratio, it will be cropped to fit.

Output Schema

File
required
The generated video.

Input Example

Output Example

Limitations

  • aspect_ratio restricted to: auto, 16:9, 9:16
  • duration restricted to: 4s, 6s, 8s
  • resolution restricted to: 720p, 1080p, 4k
  • safety_tolerance restricted to: 1, 2, 3, 4, 5, 6