Skip to main content
Model ID 
Minimax-Hailuo-02

​
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

​
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": "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

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesText description of the video to generate (max 2000 characters). Supports camera movement instructions like [Tilt Left], [Pan Right].""Required
durationenumNoVideo duration in seconds. 1080P is not available for 10s videos.6Options: 6, 10
resolutionenumNoOutput resolution.
For 6s: 512P, 768P, 1080P
For 10s: 512P, 768P		”768P”Options depend on duration
first_frame_imageimageCond.First frame image.
Required for 512P, optional for 768P or 1080P.		""Max 1 image
prompt_optimizerbooleanNoAutomatically optimize prompt for better generation qualitytruetrue / false
fast_pretreatmentbooleanNoReduce processing time during prompt optimizationfalsetrue / 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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest 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"

​
Get Model Information

​
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

  1. Clear, Descriptive Prompts: Use detailed descriptions and camera movement tags like [Tilt Left], [Pan Right].
  2. First Frame Image: Required for 512P videos, optional for 768P/1080P.
  3. Prompt Optimizer: Keep prompt_optimizer enabled for better quality.
  4. Fast Pretreatment: Use fast_pretreatment=true to reduce preprocessing time.
  5. 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
    }
  }'