Skip to main content
POST
Veo 3.1 Reference Image Video Generation
Use the Google Veo 3.1 model to generate videos guided by 1–3 reference images. Supports 720p and 1080p resolutions, as well as 16:9 and 9:16 aspect ratios. The duration is fixed at 8 seconds. The reference type only supports asset.
This is an asynchronous API and only returns the task_id of the asynchronous task. You should use this task_id to request the Get Task Result API to retrieve the generated result.

Request Headers

string
required
Enum value: application/json
string
required
Bearer authentication format: Bearer {{API Key}}.

Request Body

integer
Random seed used to reproduce generation results.Value range: [0, 4294967295]
string
required
Text prompt describing the desired video content.
string
default:"720p"
Output video resolution.Available values: 720p, 1080p
string
default:"16:9"
Output video aspect ratio.Available values: 16:9, 9:16
integer
default:1
Number of video samples to generate (1–4).Value range: [1, 4]
boolean
default:true
Whether to use AI to rewrite the prompt for better generation results.
boolean
default:false
Whether to generate audio at the same time.
string
Describes content to avoid in the generated video.
object[]
required
1–3 reference images used to guide video generation. Each element contains an image URL or Base64-encoded data and the reference type.Array length: 1 - 3
string
default:"allow_adult"
Whether to allow generating adult people. allow_adult: allow generating adults; dont_allow: do not allow generating people.Available values: allow_adult, dont_allow

Response Information

string
Use task_id to request the Get Task Result API to retrieve the generated output.