API Parameters

Complete reference for all VEO3 API parameters, validation rules, and examples.

1 Required8 OptionalType Validation

Required Parameters

Essential parameters that must be included in every request

Required Parameter
promptstring

Descriptive text for video generation

"A majestic dragon soaring through clouds above a fantasy castle"

Validation: Must be a non-empty string

Optional Parameters

Additional parameters to customize video generation

model
string
VEO model to use for generation (Fast models cannot be used with image-to-video)

Default Value

veo-3.0-generate-preview

Accepted Values

veo-3.0-generate-previewveo-3.0-fast-generate-previewveo-3.1-generate-previewveo-3.1-fast-generate-previewveo-3.1-lite-generate-preview
sampleCount
integer
Number of videos to generate

Default Value

1

Accepted Values

1-2
durationSeconds
integer
Video duration in seconds

Default Value

8

Accepted Values

5-8
aspectRatio
string
Video aspect ratio

Default Value

16:9

Accepted Values

16:99:16
generateAudio
boolean
Include AI-generated audio in the video. Enabling audio costs significantly more credits — Fast: 190 cr (audio) vs 120 cr (no audio); Quality: 500 cr (audio) vs 250 cr (no audio); Lite: 65 cr (audio) vs 35 cr (no audio). Disable to reduce costs by ~33–50%.

Default Value

true

Accepted Values

true, false
enhancePrompt
boolean
Use AI to enhance the prompt

Default Value

true

Accepted Values

true, false
negativePrompt
string
What to avoid in the video

Default Value

null

Accepted Values

Any string
seed
integer
Seed for reproducible results

Default Value

null

Accepted Values

0-4294967295
personGeneration
string
Person generation policy

Default Value

allow_adult

Accepted Values

allow_adultdont_allow

Image Upload Parameters

Used with POST /api/veo/image-to-video as multipart/form-data. Text fields are the same optional parameters as text-to-video (e.g. model, durationSeconds).

Image field
imagefileRequired

Reference image file (JPEG/PNG, max 20MB)

Validation: JPEG or PNG format, maximum 20MB

Validation Rules

Parameter validation rules and examples

Parameter Validation
prompt

Must be a non-empty string

✓ 'A beautiful sunset over mountains'
✗ Empty string or null
model

Must be a valid model ID

✓ 'veo-3.0-generate-preview'
✗ 'invalid-model'
sampleCount

Integer between 1 and 2

✓ 1 or 2
✗ 0, 3, or non-integer
durationSeconds

Integer between 5 and 8

✓ 5, 6, 7, or 8
✗ 4, 9, or non-integer
aspectRatio

Must be '16:9' or '9:16'

✓ '16:9' or '9:16'
✗ '4:3' or other ratios
seed

Integer between 0 and 4294967295

✓ 12345 or null
✗ Negative numbers or too large

Parameter Examples

Common parameter combinations and use cases

High-Quality Generation
Best quality with all features enabled
{
  "prompt": "A cinematic shot of a futuristic city at sunset",
  "model": "veo-3.0-generate-preview",
  "sampleCount": 1,
  "durationSeconds": 8,
  "generateAudio": true,
  "enhancePrompt": true,
  "negativePrompt": "blurry, low quality"
}
Fast & Cost-Effective
Quick generation for testing and prototypes
{
  "prompt": "A simple animation of a bouncing ball",
  "model": "veo-3.0-fast-generate-preview",
  "sampleCount": 1,
  "durationSeconds": 5,
  "generateAudio": false,
  "enhancePrompt": false
}
Multiple Variations
Generate 2 videos for A/B testing
{
  "prompt": "A cat playing with a ball of yarn",
  "model": "veo-3.0-fast-generate-preview", 
  "sampleCount": 2,
  "durationSeconds": 6,
  "generateAudio": true,
  "enhancePrompt": true
}
Reproducible Results
Use seed for consistent output
{
  "prompt": "A serene mountain lake at dawn",
  "model": "veo-3.0-generate-preview",
  "seed": 12345,
  "durationSeconds": 8,
  "generateAudio": true,
  "enhancePrompt": false
}

Parameter Best Practices

Tips for optimal parameter selection

Do's
  • Use descriptive and specific prompts
  • Enable prompt enhancement for better results
  • Use negative prompts to avoid unwanted content
  • Set seeds for reproducible results
  • Choose model based on quality vs speed needs
Don'ts
  • Don't use vague or generic prompts
  • Don't exceed parameter limits (duration, sample count)
  • Don't include inappropriate content in prompts
  • Don't use unsupported aspect ratios
  • Don't send extremely long prompts (> 500 words)

Next Steps

Ready to use these parameters? Explore these resources

API Endpoints
See how to use these parameters in API requests
Code Examples
Real-world examples using these parameters
Error Handling
Handle parameter validation errors properly