Skip to main content
Model ID 
Veo3

​
Veo3 API Usage Guide

​
Overview

Veo3 is Google’s most advanced video generation model, capable of creating stunning, realistic videos from text descriptions and optional reference images. With improved understanding of physics, human movement, and visual consistency, Veo3 delivers professional-quality video content for creative and commercial applications.

​
Key Features:

  • Unified Model: Supports both text-to-video and image-to-video generation
  • High Quality: Produces crisp, detailed videos with realistic motion
  • Advanced Physics: Better understanding of object interactions and movement
  • Multiple Aspect Ratios: Support for landscape (16:9) and portrait (9:16) formats
  • Responsible AI: Built-in content filtering and safety measures

​
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": "Veo3",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
      "durationSeconds": "8",
      "aspectRatio": "16:9",
      "negativePrompt": "blurry, low quality, distorted",
      "personGeneration": "allow_adult",
      "seed": null
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesThe text prompt used to guide video generation.-Required
durationSecondsstringNoVideo length in seconds”8”Options: “8”, “6”, “4”
aspectRatiostringNoDefines the aspect ratio of the generated videos.”16:9”Options: “16:9”, “9:16”
negativePromptstringNoA text string that describes what you want to discourage the model from generating.""Optional
personGenerationstringNoThe safety setting that controls whether people or face generation is allowed.”allow_all”Options: “allow_adult”, “disallow”, “allow_all”
seedintegerNoA number to make generated videos deterministic. Specifying a seed number with your request without changing other parameters guides the model to produce the same videos.null0 to 4294967295

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Veo3",
  "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",
  "model": "Veo3",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape at sunset",
    "durationSeconds": "8",
    "aspectRatio": "16:9",
    "negativePrompt": "blurry, low quality, distorted",
    "personGeneration": "allow_adult",
    "seed": 12345
  },
  "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=Veo3

​
Example

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

​
Get Model Information

​
Endpoint

GET /api/v1/ie/requestqueue/apikey/models/Veo3

​
Example

curl -X GET "https://api.example.com/api/v1/apikey/models/Veo3" \
  -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": [
        "Kling-Image2Video-V2.1-Master",
        "Kling-Text2Video-V2.1-Master",
        "Luma-Ray2",
        "Veo3",
        "Veo3-Fast",
        "Wan-AI_Wan2.1-T2V-14B",
        "Wan-AI_Wan2.1-FLF2V-14B-720P",
        "Wan-AI_Wan2.1-I2V-14B-720P"
    ]
}

​
Tips for Better Results

  1. Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality
  2. Seed Usage: Use the same seed with identical parameters for reproducible results
  3. Negative Prompts: Specify unwanted elements to improve quality

​
Examples

​
Icicles

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": "Veo3",
    "payload": {
      "prompt": "Close up shot (composition) of melting icicles (subject) on a frozen rock wall (context) with cool blue tones (ambiance), zoomed in (camera motion) maintaining close-up detail of water drips (action)",
      "durationSeconds": "8",
      "aspectRatio": "16:9"
    }
  }'

​
Running snow leopard

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": "Veo3",
    "payload": {
      "prompt": "Create a short 3D animated scene in a joyful cartoon style. A cute creature with snow leopard-like fur, large expressive eyes, and a friendly, rounded form happily prances through a whimsical winter forest. The scene should feature rounded, snow-covered trees, gentle falling snowflakes, and warm sunlight filtering through the branches. The creature's bouncy movements and wide smile should convey pure delight. Aim for an upbeat, heartwarming tone with bright, cheerful colors and playful animation. Consider adding subtle, whimsical sound effects to enhance the joyful winter atmosphere.",
      "durationSeconds": "8",
      "aspectRatio": "16:9",
    }
  }'

​
Man on the phone

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": "Veo3",
    "payload": {
      "prompt": "A video with smooth motion that dollies in on a desperate man in a green trench coat, using a vintage rotary phone against a wall bathed in an eerie green neon glow. The camera starts from a medium distance, slowly moving closer to the man's face, revealing his frantic expression and the sweat on his brow as he urgently dials the phone. The focus is on the man's hands, his fingers fumbling with the dial as he desperately tries to connect. The green neon light casts long shadows on the wall, adding to the tense atmosphere. The scene is framed to emphasize the isolation and desperation of the man, highlighting the stark contrast between the vibrant glow of the neon and the man's grim determination.",
      "durationSeconds": "8",
      "aspectRatio": "16:9",
    }
  }'