veo4api

VOL 01 / ISSUE 04/26The Playground

Filed on / Veo 4

Colophon · Press Credentials

File your fal key

To go to press with Veo 4, lodge your fal key with the composing desk. It stays local, under your byline, and bills your own fal account.

Stored in localStorage. Not transmitted.

Column · The PromptVeo 4

Please file your fal key in the colophon to go to press.

Dossier · Integration

Send Veo 4 to press.

The playground upstairs calls the same endpoint you will call in production. Below, three filed examples with matching cutlines, followed by the parameter index.

Endpointfal-ai/veo4/text-to-video

Output / video

Plate No. 01TypeScript

Plate / TS example.ts

1import { fal } from "@fal-ai/client";
2
3fal.config({ credentials: process.env.FAL_KEY });
4
5const { data } = await fal.subscribe("fal-ai/veo4/text-to-video", {
6  input: {
7    "prompt": "A documentary style street interview at night. Person looks at the camera and sa...",
8    "safety_tolerance": 3,
9    "auto_fix": false,
10    "duration": "8s",
11    "aspect_ratio": "16:9",
12    "resolution": "1080p",
13    "generate_audio": true
14  },
15  logs: true,
16});
17
18console.log(data);

The @fal-ai/client reader, for Node and browser builds.

Plate No. 02Python

Plate / PYTHON example.py

1import fal_client
2
3result = fal_client.subscribe(
4    "fal-ai/veo4/text-to-video",
5    arguments={
6      "prompt": "A documentary style street interview at night. Person looks at the camera and sa...",
7      "safety_tolerance": 3,
8      "auto_fix": false,
9      "duration": "8s",
10      "aspect_ratio": "16:9",
11      "resolution": "1080p",
12      "generate_audio": true
13    },
14    with_logs=True,
15)
16
17print(result)

The fal-client reader, for scripts and notebooks.

Plate No. 03HTTP

Plate / BASH example.sh

1curl -X POST "https://queue.fal.run/fal-ai/veo4/text-to-video" \
2  -H "Authorization: Key $FAL_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{ "prompt": "A documentary style street interview at night. Person looks at the camera and sa...", "safety_tolerance": 3, "auto_fix": false, "duration": "8s", "aspect_ratio": "16:9", "resolution": "1080p", "generate_audio": true }'

Raw queue.fal.run, for stacks without a first-party SDK.

Index · Input parameters

Key	Kind	Default	Notes
prompt	text (required)	·	Primary generation input.
duration	select	8s	4 seconds, 6 seconds, 8 seconds
aspect_ratio	select	16:9	16:9 landscape, 9:16 portrait, 1:1 square
resolution	select	1080p	720p, 1080p, 4K
generate_audio	select	true	Native audio on, Silent render
safety_tolerance	default	3	Sent with every request unless overridden.
auto_fix	default	false	Sent with every request unless overridden.

Full schema on file at fal.ai/models/fal-ai/veo4/text-to-video/llms.txt.