curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo3.1-fast-official",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic close-up of a paper boat drifting through a neon-lit canal",
"duration": 6,
"aspect_ratio": "16:9",
"resolution": "1080p",
"sound": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1780000000-veo31official",
"status": "not_started",
"created_time": "2026-05-20T10:30:00"
}
}Google
VEO 3.1 Official Video Generation
Official VEO 3.1 video generation with duration, audio control, and image-guided modes
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "veo3.1-fast-official",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "A cinematic close-up of a paper boat drifting through a neon-lit canal",
"duration": 6,
"aspect_ratio": "16:9",
"resolution": "1080p",
"sound": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1780000000-veo31official",
"status": "not_started",
"created_time": "2026-05-20T10:30:00"
}
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
VEO 3.1 Official Video Generation
Generate videos with the official VEO 3.1 model family through one async API. The generation models support text-to-video, image-to-video, first/last-frame video, and three-image reference generation depending on the selected model and input.Available Models
- veo3.1-fast-official - Fast official generation with
4,6, or8second duration options - veo3.1-lite-official - Lightweight official generation with lower per-second pricing
- veo3.1-quality-official - Higher-quality official generation with 4K support
Input Modes
- No
image_urls: text-to-video - One image: image-to-video
- Two images: first/last-frame video. The first image is the start frame and the second image is the end frame
- Three images: reference generation. Use
generation_type: "reference"andduration: 8 veo3.1-lite-officialsupports at most two images and does not supportgeneration_type: "reference"
Parameters
- model: Required model identifier. Use
veo3.1-fast-official,veo3.1-lite-official, orveo3.1-quality-official - prompt: Required text prompt for video generation, up to
1000characters - image_urls: Optional image URL array. Supports up to
3public image URLs - generation_type: Optional
frameorreference. If omitted, the mode is inferred fromimage_urls - duration:
4,6, or8. Default is8. Reference generation andveo3.1-lite-officialwithresolution: "1080p"support8only - aspect_ratio:
16:9or9:16.autois also supported for one-image and two-image workflows. Default is16:9 - resolution:
720p,1080p, or4k. Default is1080p.veo3.1-lite-officialdoes not support4k - sound: Boolean audio switch. Default is
true; setfalsefor silent output - callback_url: Optional webhook URL for completion or failure notifications
Pricing
Pricing is charged per generated second and varies by model, resolution, and whether audio is generated. See the model page for the current credit table.Workflow IDs
Existing IDs remain available. New integrations can select a dedicated workflow:- google/veo3.1/text-to-video
- google/veo3.1/image-to-video
- google/veo3.1-fast/text-to-video
- google/veo3.1-fast/image-to-video
- google/veo3.1-lite/text-to-video
- google/veo3.1-lite/image-to-video
Authorizations
All API endpoints require Bearer Token authentication
Get your API Key:
Visit the API Key Management Page to get your API Key
Add it to the request header:
Authorization: Bearer YOUR_API_KEY
Body
application/json