Model ID

Minimax-Hailuo-2.3

Calling method: async

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

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

Get Model Information

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

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

Minimax-Hailuo-2.3

Minimax-Hailuo-2.3 API Usage Guide

Overview

Key Features:

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

Examples

Quick Ocean Scene

Animated with First Frame

​Minimax-Hailuo-2.3 API Usage Guide

​Overview

​Key Features:

​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

​Examples

​Quick Ocean Scene

​Animated with First Frame

Minimax-Hailuo-2.3 API Usage Guide

Overview

Key Features:

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

Examples

Quick Ocean Scene

Animated with First Frame