seedinteger
Random seed for more reproducible results.
Minimum: 0
Maximum: 4294967295
google/veo3.1/lite/text-to-videoVeo3.1 Lite is Google's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition.
Try the model
Customize your input with more control.
What would you like to do next?
Select an example to load its inputs and result into the playground.
{
"aspect_ratio": "9:16",
"duration": 4,
"generate_audio": false,
"prompt": "A red paper lantern swaying gently in a quiet bamboo forest at dusk"
}{
"prompt": "A massive blue whale glides through crystal-clear deep ocean water, sunlight rays piercing through the surface above, bioluminescent plankton scattered around, cinematic slow motion"
}Human preference
Elo ratings from blind side-by-side votes, compared with other image and video models.
Rankings sourced from Artificial Analysis Arena
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.
Veo 3.1 Lite text-to-video, the lowest-cost Veo 3.1 tier for high-volume drafts. 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.
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 20,000 characters. |
duration | 4 / 6 / 8 | 8 | Output length in seconds. |
resolution | 720p / 1080p | 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. |
You pay for output seconds, Google's list price. With audio: $0.05 at 720p, $0.08 at 1080p. Without audio: $0.03 / $0.05 respectively.
| Output | 720p | 1080p |
|---|---|---|
| 4s with audio | $0.20 | $0.32 |
| 6s with audio | $0.30 | $0.48 |
| 8s with audio (default) | $0.40 | $0.64 |
| 8s without audio | $0.24 | $0.40 |
Failed runs are not charged.
negative_prompt for things to keep out of frame.Other Veo 3.1 Lite endpoints: google/veo3.1/lite/image-to-video, google/veo3.1/lite/first-last-frame-to-video, google/veo3.1/text-to-video, google/veo3.1/fast/text-to-video.
Start building
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/lite/text-to-video",
"prompt": "A massive blue whale glides through crystal-clear deep ocean water, sunlight rays piercing through the surface above, bioluminescent plankton scattered around, cinematic slow motion",
"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"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.
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
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"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.
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.
seedintegerRandom seed for more reproducible results.
Minimum: 0
Maximum: 4294967295
promptstringrequiredThe text prompt describing the video you want to generate
durationintegerDuration of the generated video in seconds.
Default: 8
Possible values: 4, 6, 8
resolutionstringOutput resolution.
Default: "720p"
Possible values: "720p", "1080p"
aspect_ratiostringOutput aspect ratio.
Default: "16:9"
Possible values: "16:9", "9:16"
generate_audiobooleanGenerate synchronized audio. Videos without audio are cheaper.
Default: true
negative_promptstringWhat to avoid in the video.
{
"model": "google/veo3.1/lite/text-to-video",
"prompt": "A massive blue whale glides through crystal-clear deep ocean water, sunlight rays piercing through the surface above, bioluminescent plankton scattered around, cinematic slow motion",
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}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/dafd88870140c88ccfcf.jpg",
"source": "Self organization completed prediction",
"source_url": "https://www.sandbase.ai",
"url": "https://static.sandbase.ai/examples/d118c6f9-3ca6-495d-b964-4264e6fe4255/output/48938a26-9983-4367-90d4-1d45acf1c806.mp4"
}
]