Skip to main content
POST
Veo 3.1 Fast Reference Image-to-Video Generation
Use the Google Veo 3.1 Fast 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 will only return the async task’s task_id. 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
A 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
Describe the 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 a 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.