> ## 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-2.3

> MiniMax's upgraded video model built on Hailuo 02, enhancing complex body motion, facial micro-expressions, and physical realism, with expanded style support including anime, ink wash, and game CG — better quality at the same price.

|   |   |
| --- | --- |
| **Provider** | MiniMax |
| **Tasks** | image-to-video · text-to-video |
| **Starting from** | 0.2240 USD / call · <a href="https://linkmodel.ai/en/models/MiniMax-Hailuo-2.3" target="_blank" rel="noopener">Pricing details</a> |




## OpenAPI

````yaml /openapi/video/minimax-hailuo-2-3.yaml post /video-generation
openapi: 3.0.3
info:
  title: MiniMax-Hailuo-2.3
  version: 1.0.0
  description: >-
    MiniMax's upgraded video model built on Hailuo 02, enhancing complex body
    motion, facial micro-expressions, and physical realism, with expanded style
    support including anime, ink wash, and game CG — better quality at the same
    price.
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-2.3
      description: >
        MiniMax's upgraded video model built on Hailuo 02, enhancing complex
        body motion, facial micro-expressions, and physical realism, with
        expanded style support including anime, ink wash, and game CG — better
        quality at the same price.


        |   |   |

        | --- | --- |

        | **Provider** | MiniMax |

        | **Tasks** | image-to-video · text-to-video |

        | **Starting from** | 0.2240 USD / call · <a
        href="https://linkmodel.ai/en/models/MiniMax-Hailuo-2.3" target="_blank"
        rel="noopener">Pricing details</a> |
      operationId: minimax-hailuo-2-3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - MiniMax-Hailuo-2.3
                  description: 'Must be one of: MiniMax-Hailuo-2.3.'
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 2000
                  description: Length must be between 1 and 2000.
                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
                first_frame_image:
                  type: string
                  format: url
                resolution:
                  type: string
                  enum:
                    - 1080P
                    - 768P
                  default: 768P
                  description: |-
                    Must be one of: 1080P, 768P. Defaults to `768P`.

                    **Conditional limits:**
                    - 10 seconds duration only supports 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

````