Skip to main content
POST

Authorizations

Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Veo 3.1 Lite image-to-video request. Supports prompt, image, lastFrame, negativePrompt, aspectRatio, duration, resolution (up to 1080p), and personGeneration.

prompt
string
required

Video description text guiding the animation

Minimum string length: 1
Example:

"Petals gently fall from a cherry blossom tree in a soft breeze"

image
string
required

Starting frame. Accepts an image URL (e.g. https://example.com/frame.jpg).

Example:

"https://example.com/frame.jpg"

lastFrame
string

End frame. Accepts an image URL. Optional, guides the video to end at this frame.

Example:

"https://example.com/last-frame.jpg"

negativePrompt
string

Text describing what to avoid in the generated video.

Example:

"blurry, low quality, distorted"

aspectRatio
enum<string>
default:16:9

Video aspect ratio

Available options:
16:9,
9:16
Example:

"16:9"

duration
enum<string>

Video duration in seconds (string type)

Available options:
4,
6,
8
Example:

"6"

resolution
enum<string>

Video resolution

Available options:
720p,
1080p
Example:

"720p"

personGeneration
enum<string>

Person generation policy

Available options:
allow_adult
Example:

"allow_adult"

Response

Task submitted successfully

code
integer
required

Response code, 0 indicates success

Example:

0

message
string
required

Response message

Example:

"success"

data
object
required

Detailed data about the submitted asynchronous task.