Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt

Use this file to discover all available pages before exploring further.

Model ID 
veo-3.1-generate-preview

​
veo-3.1-generate-preview API Usage Guide

​
Overview

Veo 3.1 is Google’s latest video generation model in preview. 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 or 1080p (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-preview",
    "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
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesText description of the video to generate (max 2000 characters). Describe scenes, actions, camera moves, and visual style.-Required
reference_imagestringNoProvide 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
imagestringNoOptional first frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP.-Max 1 image
lastFramestringNoOptional last frame for two-frame guided video generation. Supported formats: JPEG/PNG/WebP.-Max 1 image
durationSecondsintegerNoVideo length in seconds (4, 6, or 8). Reference image to video only supports 8 seconds.6Options: “4, 6, 8
aspectRatiostringNoAspect ratio of the generated video. Some features may restrict supported aspect ratios.”16:9”Options: “16:9”, “9:16”
generateAudiobooleanNoWhether generate audio.trueOptional
negativePromptstringNoDescribe what you don’t want to see in the video (max 500 characters).-Optional
personGenerationstringNoControl whether people can appear in the video.”allow_all”Options: “allow_all”, “allow_adult”, “disallow”
seedintegerNoRandom seed for reproducibility. Leave empty for random results.-Range: 0 to 4294967295

​
Response

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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest was cancelled

​
List Your Requests

​
Endpoint

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

​
Example

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

​
Get Model Information

​
Endpoint

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

​
Example

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

​
Tips for Better Results

  1. Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality