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-2.3 API Usage Guide
Overview
Minimax-Hailuo-2.3 is a video generation model that creates high-quality short videos from text prompts, optionally guided by first-frame images. It supports camera movement instructions (e.g., [Tilt Left], [Pan Right]) and offers flexible control over duration, resolution, and prompt optimization.
Key Features:
- Exceptional human physics, enabling dynamic and fluid movements such as flips, dancing sequences (including belly dancing and waltz), and more.
- Powerful VFX capabilities, delivering cinematic realism and immersive visual effects.
- Seamless style transformation, allowing for versatile and creative aesthetic shifts.
- Advanced stylization options, offering transformations like Pixar-style visuals and surrealist effects (e.g., water light).
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": "Minimax-Hailuo-2.3",
"payload": {
"prompt": "A serene ocean scene with waves 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 chars). Supports camera movement tags like [Tilt Left], [Pan Right]. | "" | Required |
first_frame_image | image | No | A string containing an image URL. This image will be used as the first frame in the generated video. | "" | Required for 512P; optional for 768P and 1080P. Max 1 image |
duration | enum | No | Video duration in seconds. | 6 | Options: 6, 10 |
resolution | enum | No | Output resolution. | ”768P” | For 6s: 512P, 768P, 1080P; For 10s: 512P, 768P |
prompt_optimizer | boolean | No | Automatically optimize prompt for better 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-2.3",
"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-2.3",
"status": "success",
"is_public": false,
"payload": {
"prompt": "A serene ocean scene with waves 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-2.3
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Minimax-Hailuo-2.3" \
-H "Authorization: Bearer YOUR_API_KEY"
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/Minimax-Hailuo-2.3
Example
curl -X GET "https://api.example.com/api/v1/apikey/models/Minimax-Hailuo-2.3" \
-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",
"Minimax-Hailuo-2.3"
]
}
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-2.3",
"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-2.3",
"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
}
}'
