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
Minimax-Hailuo-02 API Usage Guide
Overview
Minimax-Hailuo-02 is a video generation model that creates high-quality short videos from text prompts, optionally enhanced by a first-frame image. It supports camera movement instructions and offers flexible control over duration, resolution, and prompt optimization.
Authentication
All API requests require authentication using an API key. Include it 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": "Minimax-Hailuo-02",
"payload": {
"prompt": "A serene ocean scene with waves gently rolling under a pink sunset [Pan Right]",
"duration": 6,
"resolution": "768P",
"prompt_optimizer": true,
"fast_pretreatment": false
}
}'
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|
prompt | string | Yes | Text description of the video to generate (max 2000 characters). Supports camera movement instructions like [Tilt Left], [Pan Right]. | "" | Required |
duration | enum | No | Video duration in seconds. 1080P is not available for 10s videos. | 6 | Options: 6, 10 |
resolution | enum | No | Output resolution.
For 6s: 512P, 768P, 1080P
For 10s: 512P, 768P | ”768P” | Options depend on duration |
first_frame_image | image | Cond. | First frame image.
Required for 512P, optional for 768P or 1080P. | "" | Max 1 image |
prompt_optimizer | boolean | No | Automatically optimize prompt for better generation quality | true | true / false |
fast_pretreatment | boolean | No | Reduce processing time during prompt optimization | false | true / false |
Response
{
"request_id": "7a99e510-3b20-48d1-89a1-0cd72b6242fb",
"model": "Minimax-Hailuo-02",
"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": "7a99e510-3b20-48d1-89a1-0cd72b6242fb",
"org_id": "your-org-id",
"model": "Minimax-Hailuo-02",
"status": "success",
"is_public": false,
"payload": {
"prompt": "A serene ocean scene with waves gently rolling under a pink sunset [Pan Right]",
"duration": 6,
"resolution": "768P",
"first_frame_image": "",
"prompt_optimizer": true,
"fast_pretreatment": false
},
"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=Minimax-Hailuo-02
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Minimax-Hailuo-02" \
-H "Authorization: Bearer YOUR_API_KEY"
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/Minimax-Hailuo-02
Example
curl -X GET "https://api.example.com/api/v1/apikey/models/Minimax-Hailuo-02" \
-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 detailed descriptions and camera movement tags like [Tilt Left], [Pan Right].
- First Frame Image: Required for 512P videos, optional for 768P/1080P.
- Prompt Optimizer: Keep prompt_optimizer enabled for better quality.
- Fast Pretreatment: Use fast_pretreatment=true to reduce preprocessing time.
- Resolution Choice: For 10s videos, only 512P and 768P are available.
Examples
Quick Ocean 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": "Minimax-Hailuo-02",
"payload": {
"prompt": "A calm beach with seagulls flying across the sky [Pan Left]",
"duration": 6,
"resolution": "512P",
"prompt_optimizer": true
}
}'
Animated with First Frame
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": "Minimax-Hailuo-02",
"payload": {
"prompt": "Extend this scene into a mystical forest journey",
"duration": 10,
"resolution": "768P",
"first_frame_image": "https://example.com/frame.jpg",
"fast_pretreatment": true
}
}'
