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

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/veo3.1",
    arguments={
        "prompt": "Two person street interview in New York City.
Sample Dialogue:
Host: \"Did you hear the news?\"
Person: \"Yes! Veo 3.1 is now available on fal. If you want to see it, go check their website.\""
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Examples

First-person view soaring low over a medieval battlefield at dawn, gliding past clashing knights in armor, fire-lit arrows whizzing overhead, splintered catapults burning near fallen soldiers, flying inches above torn flags and mud-soaked ground, ambient sounds of swords striking, war cries, gallopi…
A colossal, ancient library with impossibly high shelves, where books fly and pages turn on their own. Audio: the rustle of thousands of pages turning, the soft whoosh of flying books, distant, echoing whispers, a grand, magical orchestral piece with swirling harps and enchanted woodwinds.
A luxury yatch sets sail in the Bosphorus Strait. As it gracefully navigates through the current, the Maiden’s Tower comes into view. While continuing its journey, seagulls greet it. The sounds of waves and seagulls can be heard.

​
Capabilities

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

​
API Reference

​
Input Schema

​
prompt
string
required
The text prompt describing the video you want to generate
​
aspect_ratio
AspectRatioEnum
default:"16:9"
Aspect ratio of the generated video Default value: "16:9"Possible values: 16:9, 9:16
​
duration
DurationEnum
default:"8s"
The duration of the generated video. Default value: "8s"Possible values: 4s, 6s, 8s
​
negative_prompt
string
A negative prompt to guide the video generation.
​
resolution
ResolutionEnum
default:"720p"
The resolution of the generated video. Default value: "720p"Possible values: 720p, 1080p, 4k
​
generate_audio
boolean
default:"true"
Whether to generate audio for the video. Default value: true
​
seed
integer
The seed for the random number generator.
​
auto_fix
boolean
default:"true"
Whether to automatically attempt to fix prompts that fail content policy or other validation checks by rewriting them. Default value: true
​
safety_tolerance
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

​
Output Schema

​
video
File
required
The generated video.

​
Input Example

{
  "prompt": "Two person street interview in New York City.\nSample Dialogue:\nHost: \"Did you hear the news?\"\nPerson: \"Yes! Veo 3.1 is now available on fal. If you want to see it, go check their website.\"",
  "aspect_ratio": "16:9",
  "duration": "8s",
  "resolution": "720p",
  "generate_audio": true,
  "auto_fix": true,
  "safety_tolerance": "4"
}

​
Output Example

{
  "video": {
    "url": "https://v3b.fal.media/files/b/kangaroo/oUCiZjQwEy6bIQdPUSLDF_output.mp4"
  }
}

​
Limitations

  • aspect_ratio restricted to: 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