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-fast-generate-preview
veo-3.1-fast-generate-preview API Usage Guide
Overview
Veo 3.1 Fast is a preview variant optimized for quicker turnaround. It supports generating videos from text prompts, animating a single reference image, and two-frame guidance using first and last frames. Supports 16:9 and 9:16 aspect ratios, 4/6/8-second durations, 24 FPS.
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": "veo-3.1-fast-generate-preview",
"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": 6,
"aspectRatio": "16:9",
"generateAudio": true,
"negativePrompt": "blurry, low quality, distorted",
"personGeneration": "allow_all",
"seed": 0
}
}'
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. Supported formats: JPEG/PNG/WebP. | - | Max 1 image |
durationSeconds | integer | No | Video length in seconds (4, 6, or 8). Reference image to video only supports 8 seconds. | 6 | Options: “4, 6, 8 |
aspectRatio | string | No | Aspect ratio of the generated video. Some features may restrict supported aspect ratios. | ”16:9” | Options: “16:9”, “9:16” |
generateAudio | boolean | No | Whether generate audio. | true | Optional |
negativePrompt | string | No | Describe what you don’t want to see in the video (max 500 characters). | - | 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 |
Response
{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"model": "veo-3.1-fast-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-fast-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
| 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-fast-generate-preview
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=veo-3.1-fast-generate-preview" \
-H "Authorization: Bearer YOUR_API_KEY"
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/veo-3.1-fast-generate-preview
Example
curl -X GET "https://api.example.com/api/v1/apikey/models/veo-3.1-fast-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-fast-generate-preview",
"other-model-1",
"other-model-2"
]
}
Tips for Better Results
- Clear, Descriptive Prompts: Use specific, detailed descriptions for better video quality
