Model ID

Veo3-Fast

Veo3-Fast API Usage Guide

Overview

Key Features:

Faster Processing: Optimized for quicker video generation compared to standard Veo3
Cost Effective: More affordable pricing while maintaining quality
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
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-Fast",
    "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	Yes	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-Fast",
  "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-Fast",
  "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-Fast

Example

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

Get Model Information

Endpoint

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

Example

curl -X GET "https://api.example.com/api/v1/apikey/models/Veo3-Fast" \
  -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
Duration Selection: Choose shorter durations (5-6 seconds) for faster processing and lower costs
Optimized for Speed: Veo3-Fast is designed for quicker turnaround times while maintaining quality

Examples

Quick Nature Scene

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-Fast",
    "payload": {
      "prompt": "Close up shot of melting icicles on a frozen rock wall with cool blue tones, zoomed in maintaining close-up detail of water drips",
      "durationSeconds": "8",
      "aspectRatio": "16:9"
    }
  }'

Animated Character

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-Fast",
    "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.",
      "aspectRatio": "16:9"
    }
  }'

Dramatic Scene

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-Fast",
    "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.",
      "durationSeconds": "8",
      "aspectRatio": "16:9"
    }
  }'

Documentation Index

​Veo3-Fast API Usage Guide

​Overview

​Key Features:

​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

​Tips for Better Results

​Examples

​Quick Nature Scene

​Animated Character

​Dramatic Scene

Veo3-Fast API Usage Guide

Overview

Key Features:

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

Tips for Better Results

Examples

Quick Nature Scene

Animated Character

Dramatic Scene