Model ID

veo-3.1-generate-001

Calling method: async

veo-3.1-generate-001 API Usage Guide

Overview

Veo 3.1 is Google’s latest video generation model . It supports generating videos from text prompts, animating a single reference image, and generating videos guided by both a first and last frame. It offers 16:9 and 9:16 aspect ratios, durations of 4/6/8 seconds, and produces 24 FPS videos at 720p, 1080p, or 4K resolution (availability may vary by feature).

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Base URL

https://console.gmicloud.ai

Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

Request Format

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "reference_image": "https://example.com/reference_image.jpg",
      "image": "https://example.com/image.jpg",
      "lastFrame": "https://example.com/lastFrame.jpg",
      "durationSeconds": 6,
      "aspectRatio": "16:9",
      "generateAudio": true,
      "negativePrompt": "blurry, low quality, distorted",
      "personGeneration": "allow_all",
      "seed": 0,
      "resolution": "1080p"
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`prompt`	string	Yes	Text description of the video to generate (max 2000 characters). Describe scenes, actions, camera moves, and visual style.	-	Required
`reference_image`	string	No	Provide up to three images of a single person, character, or product. Veo preserves the subject’s appearance in the output video.The aspect ratio MUST be 16:9 if a reference image is provided. Reference images will be ignored if a frame image is provided. Supported formats: jpeg, png, webp.	-	Max 3 images
`image`	string	No	Optional first frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP.	-	Max 1 image
`lastFrame`	string	No	Optional last frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP.	-	Max 1 image
`durationSeconds`	integer	No	Video length in seconds (4, 6, or 8). Reference image to video only supports 8 seconds.	6	Options: “4, 6, 8
`aspectRatio`	string	No	Aspect ratio of the generated video. Some features may restrict supported aspect ratios.	”16:9”	Options: “16:9”, “9:16”
`generateAudio`	boolean	No	Whether generate audio.	true	Optional
`negativePrompt`	string	No	Describe what you don’t want to see in the video (max 500 characters).	-	Optional
`personGeneration`	string	No	Control whether people can appear in the video.	”allow_all”	Options: “allow_all”, “allow_adult”, “disallow”
`seed`	integer	No	Random seed for reproducibility. Leave empty for random results.	-	Range: 0 to 4294967295
`resolution`	string	No	Output video resolution. Higher resolutions take longer to generate.	”720p”	Options: “720p”, “1080p”, “4k”

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-generate-001",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}

Check Request Status

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "your-org-id",
  "user_id": "your-user-id",
  "model": "veo-3.1-generate-001",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
    "reference_image": "https://example.com/reference_image.jpg",
    "image": "https://example.com/image.jpg",
    "lastFrame": "https://example.com/lastFrame.jpg",
    "durationSeconds": 6,
    "aspectRatio": "16:9",
    "generateAudio": true,
    "negativePrompt": "blurry, low quality, distorted",
    "personGeneration": "allow_all",
    "seed": 0,
    "resolution": "1080p"
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930,
  "queued_at": 1750442925
}

Request Status Values

Status	Description
`queued`	Request is waiting to be processed
`processing`	Video generation is in progress
`success`	Video generation completed successfully
`failed`	Video generation failed
`cancelled`	Request was cancelled

List Your Requests

Endpoint

GET api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-generate-001

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-generate-001" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Model Information

Endpoint

GET /api/v1/ie/requestqueue/apikey/models/veo-3.1-generate-001

Example

curl -X GET "https://api.example.com/api/v1/apikey/models/veo-3.1-generate-001" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Available Models

Endpoint

GET /api/v1/apikey/models

Example

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
    "model_ids": [
        "veo-3.1-generate-001",
        "other-model-1",
        "other-model-2"
    ]
}

Pricing

Pricing Type: Video length based pricing
Unit Price: $0.40 per second

Tips for Better Results

Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality
Negative Prompts: Specify unwanted elements to improve quality

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

veo-3.1-generate-001

veo-3.1-generate-001 API Usage Guide

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Tips for Better Results

​veo-3.1-generate-001 API Usage Guide

​Overview

​Authentication

​Submit Video Generation Request

​Base URL

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Pricing

​Tips for Better Results

veo-3.1-generate-001 API Usage Guide

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Pricing

Tips for Better Results