Veo 3.1 Image-to-Video
Video
Veo 3.1 Image-to-Video
POST
Veo 3.1 Image-to-Video
The Veo 3.1 Preview API has been automatically made compatible with this endpoint
Request Headers
string
required
Enum value:
application/jsonstring
required
Bearer authentication format: Bearer {{API Key}}.
Request Body
string
required
A text string describing the video you want to generate.
string
Input image, supporting either a URL or base64-encoded format.
string
Ending image, used to fill the last frame of the video. Supports either a URL or base64-encoded format.
object[]
A list of up to three
asset images or up to one style image, used to describe the reference images the model should use when generating the video.string
Specifies the aspect ratio of the generated video.Enum values:
16:9, 9:16. The default value is 16:9.integer
The length of the video file you want to generate, in seconds.Enum values:
4, 6, 8; when using reference_images, it can only be 8.The default value is 8.boolean
Specifies whether to use Gemini to enhance your prompt. Only
true is supported.Default value: trueboolean
required
Specifies whether to generate audio for the video.
string
A text string describing what you want to prevent the model from generating.
string
A safety setting that controls whether person or face generation is allowed.Enum values:
allow_adult(default): Only allows generating adultsdont_allow: Does not allow people or faces to be included in the imageallow_all: Allows generating people of all ages (requires the project to be on the allowlist)
string
The resolution of the generated video.Enum values:
720p (default) or 1080pinteger
The number of video samples to generate.Value range: 1-4
uint32
A number used to initialize the random generation process. Using the same seed, prompt, and other parameters will produce the same output video, making the generation process deterministic.Value range: 0-4,294,967,295
Response Parameters
string
required
The task_id of the asynchronous task. You should use this task_id to request the Query Task Result API to obtain the generated result