Parameters

Complete reference for all VEO3 API parameters. Learn about required and optional parameters, validation rules, data types, and usage examples.

1 Required9 OptionalStrongly Typed

Required Parameters

These parameters must be included in every video generation request

promptRequired
Text description of the video to generate
Type:

string

Constraints:

Non-empty string, max 1000 characters

Example:

A majestic dragon soaring through clouds above a fantasy castle

Optional Parameters

These parameters have default values and can be omitted from requests

modelOptional
VEO model to use for generation
Type:

string

Default:

veo-3.0-generate-preview

Values::

veo-3.0-generate-preview, veo-3.0-fast-generate-preview

Example:

veo-3.0-fast-generate-preview

Validation:

Must be a valid model ID

sampleCountOptional
Number of videos to generate in single request
Type:

integer

Default:

1

Range::

1-2

Example:

2

Validation:

Integer between 1 and 2

durationSecondsOptional
Video duration in seconds
Type:

integer

Default:

8

Range::

5-8

Example:

8

Validation:

Integer between 5 and 8 (all billed as 8 seconds)

aspectRatioOptional
Video aspect ratio
Type:

string

Default:

16:9

Values::

16:9, 9:16

Example:

16:9

Validation:

Currently only 16:9 supported

generateAudioOptional
Whether to generate audio for the video
Type:

boolean

Default:

true

Values::

true, false

Example:

true

Validation:

Boolean value

enhancePromptOptional
Use AI to enhance and optimize the prompt
Type:

boolean

Default:

true

Values::

true, false

Example:

true

Validation:

Boolean value

negativePromptOptional
What to avoid in the generation
Type:

string

Default:

null

Values::

Example:

blurry, low quality, dark

Validation:

Optional string, max 500 characters

seedOptional
Seed for reproducible results
Type:

integer

Default:

null

Range::

0-4294967295

Example:

12345

Validation:

Optional integer for deterministic output

personGenerationOptional
Person generation policy
Type:

string

Default:

allow_adult

Values::

allow_adult, dont_allow

Example:

allow_adult

Validation:

Controls if people can appear in videos

Image Upload Parameters

Parameters specific to image-to-video generation endpoint

imageFile Upload
Image file for image-to-video generation
Supported Formats:
JPEGPNG
Max Size:

20MB

Constraints:

JPEG or PNG, max 20MB

Usage Examples

Common parameter combinations for different use cases

Basic Text-to-Video
Minimal parameters for quick generation
{
  "prompt": "A peaceful sunset over the ocean",
  "model": "veo-3.0-fast-generate-preview"
}
High-Quality Generation
Full parameter set for premium quality
{
  "prompt": "A futuristic cityscape with flying cars and neon lights",
  "model": "veo-3.0-generate-preview",
  "sampleCount": 2,
  "durationSeconds": 8,
  "aspectRatio": "16:9",
  "generateAudio": true,
  "enhancePrompt": true,
  "negativePrompt": "blurry, low quality, dark",
  "seed": 42,
  "personGeneration": "allow_adult"
}
Image-to-Video
Parameters for animating static images
{
  "image": "landscape.jpg",
  "prompt": "Animate this landscape with gentle wind movement",
  "model": "veo-3.0-generate-preview",
  "durationSeconds": 8,
  "generateAudio": true,
  "enhancePrompt": true
}
Reproducible Generation
Using seed for consistent results
{
  "prompt": "A cat playing in a garden",
  "model": "veo-3.0-generate-preview",
  "seed": 123456,
  "enhancePrompt": false
}

Validation Rules

Parameter validation is strict. Submitting invalid parameters will result in a 400 error. It's recommended to validate inputs on your end before sending requests.

Text Parameters
  • Prompt must be non-empty and under 1000 characters
  • Negative prompt is optional, max 500 characters
  • Model ID must match available models exactly
  • String values are case-sensitive
Numeric Parameters
  • sampleCount: 1 or 2 only
  • durationSeconds: 5, 6, 7, or 8 seconds
  • seed: 0 to 4,294,967,295 (32-bit unsigned integer)
  • All numeric values must be valid integers
Boolean Parameters
  • generateAudio: true or false
  • enhancePrompt: true or false
  • Boolean values must be actual booleans, not strings
  • Default values apply when parameter is omitted
File Parameters
  • Images: JPEG or PNG format only
  • Maximum file size: 20MB
  • Minimum resolution: 256x256 pixels
  • Maximum resolution: 4096x4096 pixels

Common Mistakes

Avoid these common parameter validation errors

Using string values for booleans
Boolean parameters must be actual boolean values, not strings
Wrong
"generateAudio": "true"
Correct
"generateAudio": true
Invalid model ID
Model IDs must match exactly, including the '-preview' suffix
Wrong
"model": "veo-3.0-generate"
Correct
"model": "veo-3.0-generate-preview"
Duration outside valid range
Duration must be between 5-8 seconds
Wrong
"durationSeconds": 10
Correct
"durationSeconds": 8
Too many videos in request
Maximum 2 videos per request
Wrong
"sampleCount": 5
Correct
"sampleCount": 2

Parameter Compatibility

Understanding how parameters work together

Compatible Combinations
  • All parameters work with both models
  • seed + enhancePrompt=false for reproducible results
  • sampleCount + different seeds for variety
  • negativePrompt + enhancePrompt for refined output
Special Considerations
  • Image uploads override model selection
  • VEO Fast doesn't support image-to-video
  • enhancePrompt may alter reproducibility
  • Duration affects billing (always 8s minimum)

Next Steps

Learn about error handling and see practical examples

Error Handling
Learn about validation errors and troubleshooting
Examples
See parameters in action with code examples
API Endpoints
Understand how parameters work with endpoints