Model ID

veo-3.1-lite-generate-001

Calling method: async

veo-3.1-lite-generate-001 API Usage Guide

Overview

Veo 3.1 Lite is a cost-effective variant of Google’s Veo 3.1 video generation model. It supports generating videos from text prompts and two-frame (first + last frame) guided generation. It offers 16:9 and 9:16 aspect ratios, durations of 4/6/8 seconds, and produces 24 FPS videos at 720p or 1080p resolution.

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-lite-generate-001",
    "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": 8,
      "aspectRatio": "16:9",
      "generateAudio": true,
      "personGeneration": "allow_all",
      "seed": 0,
      "resolution": "720p"
    }
  }'

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. Requires `image` to also be set. Supported formats: JPEG/PNG/WebP.	-	Max 1 image
`durationSeconds`	integer	No	Video length in seconds (4, 6, or 8).	8	Options: 4, 6, 8
`aspectRatio`	string	No	Aspect ratio of the generated video.	”16:9”	Options: “16:9”, “9:16”
`generateAudio`	boolean	No	Whether to generate audio.	true	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. Lite supports 720p and 1080p only.	”720p”	Options: “720p”, “1080p”

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "veo-3.1-lite-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-lite-generate-001",
  "status": "success",
  "is_public": false,
  "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": 8,
    "aspectRatio": "16:9",
    "generateAudio": true,
    "personGeneration": "allow_all",
    "seed": 0,
    "resolution": "720p"
  },
  "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-lite-generate-001

Example

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

Get Model Information

Endpoint

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

Example

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

Pricing

Pricing Type: Video length based pricing
720p Video + Audio: $0.05 per second
1080p Video + Audio: $0.08 per second
720p Video only: $0.03 per second
1080p Video only: $0.05 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-lite-generate-001

veo-3.1-lite-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-lite-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-lite-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