Model ID

Minimax-Hailuo-02

Calling method: async

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

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"

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

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
    }
  }'

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Minimax-Hailuo-02

Minimax-Hailuo-02 API Usage Guide

Overview

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 Ocean Scene

Animated with First Frame

​Minimax-Hailuo-02 API Usage Guide

​Overview

​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 Ocean Scene

​Animated with First Frame

Minimax-Hailuo-02 API Usage Guide

Overview

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 Ocean Scene

Animated with First Frame