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

fast

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
  }
}
'

200

Example

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1780000000-veo31official",
    "status": "not_started",
    "created_time": "2026-05-20T10:30:00"
  }
}

1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
2. Regardless of whether callback_url is 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, or 8 second 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" and duration: 8
• veo3.1-lite-official supports at most two images and does not support generation_type: "reference"

Parameters

• model: Required model identifier. Use veo3.1-fast-official, veo3.1-lite-official, or veo3.1-quality-official
• prompt: Required text prompt for video generation, up to 1000 characters
• image_urls: Optional image URL array. Supports up to 3 public image URLs
• generation_type: Optional frame or reference. If omitted, the mode is inferred from image_urls
• duration: 4, 6, or 8. Default is 8. Reference generation and veo3.1-lite-official with resolution: "1080p" support 8 only
• aspect_ratio: 16:9 or 9:16. auto is also supported for one-image and two-image workflows. Default is 16:9
• resolution: 720p, 1080p, or 4k. Default is 1080p. veo3.1-lite-official does not support 4k
• sound: Boolean audio switch. Default is true; set false for 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.

Authorizations

Authorization · string · header · required

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

model · enum<string> · required

VEO 3.1 official model identifier

Available options: veo3.1-fast-official, veo3.1-lite-official, veo3.1-quality-official

Example:

"veo3.1-fast-official"

input · object · required

Input parameters for generation

Show child attributes

callback_url · string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

200

application/json

Task submitted successfully

code · integer · required

Response code

Example:

200

data · object · required

Submitted task metadata

Show child attributes