curl --request POST \
  --url https://api.modellix.ai/api/v1/minimax/hailuo-02-t2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A peaceful beach at sunset with gentle waves"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

Hailuo 02 T2V

[Core Function] Hailuo 02 T2V is a text-to-video generation model optimized for physical realism. [Strengths] It excels at complex physics simulation, fluid dynamics, broad cinematic scenes, and natively rendering 1080p video up to 10 seconds without downscaling. [Best For] Highly recommended for: product commercials, high-speed sports action, nature documentaries, and sweeping landscapes. [Limitations] Do NOT use this model for highly stylized anime/art or nuanced human micro-expressions, where Hailuo 2.3 performs better. [Routing] Route to this model when the user requests ‘1080p for 10 seconds’, complex physical action (like splashing water or crashes), or broad landscapes. For human characters and stylization, use Hailuo 2.3 T2V.

POST

minimax

hailuo-02-t2v

curl --request POST \
  --url https://api.modellix.ai/api/v1/minimax/hailuo-02-t2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A peaceful beach at sunset with gentle waves"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

prompt

string

required

Video content description, supports Chinese and English

Required string length: 1 - 2000

Example:

"A peaceful beach at sunset with gentle waves"

prompt_optimizer

boolean

default:true

Enable automatic prompt optimization

Example:

true

fast_pretreatment

boolean

default:false

Fast pretreatment mode (only effective when prompt_optimizer=true)

Example:

false

duration

enum<integer>

default:6

Video duration in seconds

Available options:

6,

10

Example:

6

resolution

enum<string>

default:768P

Video resolution

Available options:

768P,

1080P

Example:

"768P"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Hailuo 02 i2v Hailuo 2 3 fast i2v