seedinteger
Random seed for more reproducible results.
Minimum: 0
Maximum: 4294967295
Veo 3.1 Text to Video
google/veo3.1/text-to-videoVeo3.1 by Google - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.
Try the model
Playground
Input
The text prompt describing the video you want to generate
Additional Settings More
Customize your input with more control.
Duration of the generated video in seconds. Allowed values: 4, 6, 8.
Output resolution. Allowed values: 720p, 1080p, 4k.
Output aspect ratio. Allowed values: 16:9, 9:16.
Generate synchronized audio. Videos without audio are cheaper.
What to avoid in the video.
Random seed for more reproducible results. Range: 0 to 4294967295.
ResultExample
What would you like to do next?
Examples
Select an example to load its inputs and result into the playground.
- Open result ↗
Input
{ "duration": 4, "generate_audio": false, "prompt": "A red paper lantern swaying gently in a quiet bamboo forest at dusk" } - Open result ↗
Input
{ "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.\"" }
Human preference
Arena
Elo ratings from blind side-by-side votes, compared with other image and video models.
Rankings sourced from Artificial Analysis Arena
- Leaderboard
- Text to Video
- Rank
- #20 of 33
- Elo
- 959 ±17
- Gap to #1
- −184
Text-to-video arena (silent): people pick the better of two clips from the same prompt, without seeing the model names; audio is not judged.
- #15MAGI-2 Preview1008±16
- #16Kling 3.0 1080p (Pro)1000
- #17PixVerse V6993±17
- #18Kling 3.0 Omni 1080p (Pro)982±17
- #19Grok Imagine Video 1.5 Lite974±17
- #20Veo 3.1959±17
- #21Veo 3.1 Fast959±17
- #22Veo 3.1 Lite941±17
- #23LTX-2.5 Fast929±17
- #24LTX-2.5 Pro928±17
Veo 3.1 Text to Video
Veo 3.1 text-to-video, Google's highest-quality video model. Write a scene and get back a 4, 6, or 8 second clip with native audio: dialogue, music, and sound effects generated alongside the picture.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 20,000 characters. |
duration | 4 / 6 / 8 | 8 | Output length in seconds. |
resolution | 720p / 1080p / 4k | 720p | Sets the per-second rate. |
aspect_ratio | 16:9 / 9:16 | 16:9 | Output frame shape. |
generate_audio | boolean | true | Native dialogue, music, and effects; turning it off lowers the rate. |
negative_prompt | string | — | What to avoid. |
seed | integer 0–4294967295 | random | Fix it to compare prompt changes. |
Billing
You pay for output seconds, Google's list price. With audio: $0.40 at 720p, $0.40 at 1080p, $0.60 at 4k. Without audio: $0.20 / $0.20 / $0.40 respectively.
| Output | 720p | 1080p | 4k |
|---|---|---|---|
| 4s with audio | $1.60 | $1.60 | $2.40 |
| 6s with audio | $2.40 | $2.40 | $3.60 |
| 8s with audio (default) | $3.20 | $3.20 | $4.80 |
| 8s without audio | $1.60 | $1.60 | $3.20 |
Failed runs are not charged.
Prompting
- Describe subject, action, setting, camera, and light, then the sound.
- Put dialogue in quotes and name the speaker.
- Use
negative_promptfor things to keep out of frame.
Limits
- Clips are 4, 6, or 8 seconds; chain
video-extendcalls for longer shots. - Use Veo 3.1 Fast for cheaper drafts.
Also on SandBase
Other Veo 3.1 endpoints: google/veo3.1/image-to-video, google/veo3.1/first-last-frame-to-video, google/veo3.1/reference-to-video, google/veo3.1/video-extend, google/veo3.1/fast/text-to-video, google/veo3.1/lite/text-to-video.
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "google/veo3.1/text-to-video",
"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.\"",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
promptstringrequired
The text prompt describing the video you want to generate
durationinteger
Duration of the generated video in seconds.
Default: 8
Possible values: 4, 6, 8
resolutionstring
Output resolution.
Default: "720p"
Possible values: "720p", "1080p", "4k"
aspect_ratiostring
Output aspect ratio.
Default: "16:9"
Possible values: "16:9", "9:16"
generate_audioboolean
Generate synchronized audio. Videos without audio are cheaper.
Default: true
negative_promptstring
What to avoid in the video.
{
"model": "google/veo3.1/text-to-video",
"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.\"",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"poster": "https://static.sandbase.ai/examples/posters/a9f45c6a4e4c96cf130e.jpg",
"source": "Self organization completed prediction",
"source_url": "https://www.sandbase.ai",
"url": "https://static.sandbase.ai/examples/1ce54b15-a75d-45dc-bd19-f6392646063c/output/afe63dd1-9299-4cc6-beca-45db358cf357.mp4"
}
]