# Google Veo3.1 Lite Text to Video API

> Veo3.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.

Source: https://www.sandbase.ai/models/google/veo3.1/lite
API reference: https://www.sandbase.ai/models/google/veo3.1/lite#api

## Facts

- Provider: Google
- Type: Video model
- Model ID: `google/veo3.1/lite`
- Price: From $0.40 per run
- Capabilities: text to video
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/veo3.1/lite",
  "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",
  "auto_fix": true,
  "duration": 8,
  "resolution": "720p",
  "generate_audio": true
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Google Veo3.1 Lite Text to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "google/veo3.1/lite" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Google account?

No. One SandBase API key and balance gives you access to Google Veo3.1 Lite Text to Video and the other models in the catalog; you do not need to sign up with Google separately.

## README

### Veo3.1 Lite Text to Video

google/veo3.1/lite creates a cinematic video from written scene direction, interpreting subject action, environment, camera language, lighting, and pacing. Veo 3.1 improves instruction following, physical consistency, character continuity, and audiovisual quality while supporting more ways to anchor or continue a shot. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with `google/veo3.1/lite`, this Lite text-guided video generation workflow prioritizes economical exploration for early concepts and repeated variants while retaining Veo's core motion and audiovisual abilities. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

#### Highlights

**Cinematic prompt** interpretation turns scene, action, lens, lighting, and camera language into moving imagery.

**Improved physical** coherence strengthens object interactions, character movement, and cause-and-effect across shots.

**Cost-efficient generation** enables broad iteration and high-volume video experimentation.

**Native audio** generation coordinates dialogue, ambience, and sound effects with the visual action.

#### Pricing

| Duration | Audio off | Audio on |
|---:|---:|---:|
| 4 seconds | $0.120 | $0.200 |
| 6 seconds | $0.180 | $0.300 |
| 8 seconds | $0.240 | $0.400 |

#### When to Use

| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The model's named workflow matches the source material and intended output | A different input modality or model route is required |
| A managed asynchronous result is suitable for the production pipeline | A synchronous, interactive editor is essential |
| The documented controls cover the required duration, framing, or format | The project needs controls outside this endpoint's schema |
| Creative iteration benefits from a repeatable request structure | Exact deterministic pixels, frames, geometry, or samples are mandatory |
| A finished downloadable media asset is the desired deliverable | Editable source layers or a native project file are required |

#### Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

```json
{
  "aspect_ratio": "21:9",
  "duration": 8,
  "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",
  "resolution": "720p"
}
```

#### Technical Specs

| Spec | Value |
|---|---|
| Model ID | `google/veo3.1/lite` |
| Inputs | aspect_ratio, auto_fix, duration, generate_audio, prompt, resolution, seed |
| Required inputs | prompt |
| Output fields | content_type, url |
| Execution | Async (submit, then poll for result) |
| Duration | 4 / 6 / 8 |
| Resolution | 720p / 1080p |
| Aspect Ratio | 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16 |

#### Related Models

- [google/gemini-omni-flash/1.1/text-to-video](/models/google/gemini-omni-flash/1.1/text-to-video)
