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
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
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
| Parameter | Type | Required | Description | Default | Constraints |
|---|
prompt | string | Yes | The text prompt used to guide video generation. | - | Required |
durationSeconds | string | No | Video length in seconds | ”8” | Options: “8”, “6”, “4” |
aspectRatio | string | No | Defines the aspect ratio of the generated videos. | ”16:9” | Options: “16:9”, “9:16” |
negativePrompt | string | No | A text string that describes what you want to discourage the model from generating. | "" | Optional |
personGeneration | string | No | The safety setting that controls whether people or face generation is allowed. | ”allow_all” | Options: “allow_adult”, “disallow”, “allow_all” |
seed | integer | No | A 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. | null | 0 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
| 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=Veo3
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Veo3" \
-H "Authorization: Bearer YOUR_API_KEY"
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
- Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality
- Seed Usage: Use the same seed with identical parameters for reproducible results
- 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",
}
}'
