Model ID

veo-3.1-fast-generate-preview

Calling method: async

veo-3.1-fast-generate-preview API Usage Guide

Overview

Veo 3.1 Fast is a preview variant optimized for quicker turnaround. It supports generating videos from text prompts, animating a single reference image, and two-frame guidance using first and last frames. Supports 16:9 and 9:16 aspect ratios, 4/6/8-second durations, 24 FPS.

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-fast-generate-preview",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "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
    }
  }'

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
`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

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-fast-generate-preview",
  "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-fast-generate-preview",
  "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
  },
  "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-fast-generate-preview

Example

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

Get Model Information

Endpoint

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

Example

curl -X GET "https://api.example.com/api/v1/apikey/models/veo-3.1-fast-generate-preview" \
  -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-fast-generate-preview",
        "other-model-1",
        "other-model-2"
    ]
}

Pricing

Pricing Type: Video length based pricing
Unit Price: $0.15 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-fast-generate-preview

veo-3.1-fast-generate-preview 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-fast-generate-preview 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-fast-generate-preview 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