Create video generation task
Gemini Video (Veo 2/3/3.1)
veo2/veo3 video generation
Generate video from text or images:
- TEXT2VIDEO: Generate video from text prompt
- IMG2VIDEO: Generate video from 1-2 images (start frame / start+end frames)
Note: For upscaling (1080P/4K) or GIF generation, use /video/upsample endpoint.
POST
Create video generation task
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Video description/prompt (English recommended for best results)
Example:
"A fluffy orange cat running through a sunny meadow"
Video generation action
Available options:
text2video, img2video, ingredients2video Example:
"text2video"
Video generation model. Note: INGREDIENTS2VIDEO only supports veo31_fast
Available options:
veo2_fast, veo2_quality, veo3_fast, veo3_quality, veo31_fast, veo31_quality, veo31_fast_ingredients Example:
"veo31_fast"
Image URLs for image-based video generation:
- IMG2VIDEO: 1-2 images (start frame, or start + end frames)
- INGREDIENTS2VIDEO: 1-3 reference images (required)
- veo31_fast_ingredients model: 1-3 images
Example:
[
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
]Video aspect ratio
Available options:
16:9, 9:16 Example:
"16:9"
[已废弃] Enable automatic prompt translation to English
Example:
false
Response
201 - application/json
task id, used to get task result later