Skip to main content
POST
Veo 3.1 Lite
Cost-efficient Veo 3.1 with text/image/frame-to-video workflows.

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

Text prompt for video generation

mode
string

Generation mode: text-image or frames

image_url
string

Input image URL for image-to-video

image_urls
string[]

Input image URLs for image-to-video

first_frame_url
string

First frame image for frames mode

last_frame_url
string

Last frame image for frames mode

resolution
enum<string>
default:720p

Resolution of the generated video

Available options:
720p,
1080p
aspect_ratio
enum<string>
default:16:9

Video aspect ratio

Available options:
16:9,
9:16
negative_prompt
string | null

Description of what to exclude from the generated video

seed
integer | null

Random seed. Omit for random generations

Required range: -9007199254740991 <= x <= 9007199254740991
auto_fix
boolean
default:true

Automatically rewrite prompts to pass moderation checks

n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.