> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkmodel.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# MiniMax-Hailuo-02
> MiniMax's cinematic AI video generation model built on its proprietary NCR architecture with 2.5x efficiency gains, supporting native 1080p output, extreme physics simulation, and precise instruction following, ranked among the top global video models.
| | |
| --- | --- |
| **Provider** | MiniMax |
| **Tasks** | image-to-video · text-to-video |
| **Starting from** | 0.0800 USD / call · Pricing details |
## OpenAPI
````yaml /openapi/video/minimax-hailuo-02.yaml post /video-generation
openapi: 3.0.3
info:
title: MiniMax-Hailuo-02
version: 1.0.0
description: >-
MiniMax's cinematic AI video generation model built on its proprietary NCR
architecture with 2.5x efficiency gains, supporting native 1080p output,
extreme physics simulation, and precise instruction following, ranked among
the top global video models.
servers:
- url: https://api.linkmodel.ai/api/v1
description: Production
security:
- bearerAuth: []
tags:
- name: MiniMax
- name: video
paths:
/video-generation:
post:
tags:
- MiniMax
- video
summary: MiniMax-Hailuo-02
description: >
MiniMax's cinematic AI video generation model built on its proprietary
NCR architecture with 2.5x efficiency gains, supporting native 1080p
output, extreme physics simulation, and precise instruction following,
ranked among the top global video models.
| | |
| --- | --- |
| **Provider** | MiniMax |
| **Tasks** | image-to-video · text-to-video |
| **Starting from** | 0.0800 USD / call · Pricing details |
operationId: minimax-hailuo-02
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
model:
type: string
enum:
- MiniMax-Hailuo-02
description: 'Must be one of: MiniMax-Hailuo-02.'
prompt:
type: string
minLength: 1
maxLength: 2000
description: Length must be between 1 and 2000.
first_frame_image:
type: string
format: url
last_frame_image:
type: string
format: url
duration:
type: integer
enum:
- 6
- 10
default: 6
description: |-
Must be one of: 6, 10. Defaults to `6`. Value is in s.
**Conditional limits:**
- 1080P resolution only supports 6 seconds duration
resolution:
type: string
enum:
- 1080P
- 512P
- 768P
default: 768P
description: |-
Must be one of: 1080P, 512P, 768P. Defaults to `768P`.
**Conditional limits:**
- 512P resolution requires first_frame_image to be provided
- last_frame_image only supports 768P and 1080P resolution
- 10 seconds duration only supports 512P and 768P resolution
required:
- model
- prompt
responses:
'200':
description: Task accepted and queued for generation.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 0
data:
type: object
properties:
task_id:
type: string
format: uuid
description: Use this id to poll task status.
example: cb6111cf-e89f-4978-b8e3-aa59c21cceff
order_id:
type: string
format: uuid
description: Billing order id.
example: 019da9cf-d1db-78e1-ac23-526774d01193
status:
type: string
enum:
- processing
- succeeded
- failed
example: processing
price:
type: number
description: Charged amount in the model's pricing currency.
example: 0.074
msg:
type: string
example: success
request_id:
type: string
format: uuid
example: 250b66dd-e1fb-4bb6-b5f6-c668efadc35d
'400':
description: Bad request — invalid or missing parameter.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 400
msg:
type: string
example: task_id is required
request_id:
type: string
format: uuid
example: 96be7a7d-3e81-4916-a6b8-19b32773a693
'401':
description: Unauthorized — missing or invalid API key.
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 401
data:
type: object
example: {}
msg:
type: string
example: invalid api key
request_id:
type: string
format: uuid
example: bff4c295-c7da-4507-9708-4627cb6373ba
'500':
description: Internal error — task creation failed (e.g. insufficient balance).
content:
application/json:
schema:
type: object
properties:
code:
type: integer
example: 500
msg:
type: string
example: >-
create task failed: billing: code=100601: insufficient
balance
request_id:
type: string
format: uuid
example: 3409f6fb-fa9a-4534-b530-195b5f6f4e32
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
````