> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pollo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax H3 API Documentation

> MiniMax H3 API delivers multi-shot video generation with native synced audio and precise camera control. It supports advanced keyframe editing and asset referencing to ensure consistent narrative sequences. Integrate the MiniMax H3 API now.

Check out MiniMax H3 API pricing [here](https://api.pollo.ai/pricing?modelName=minimax-hailuo-03\&modelType=video), cheaper than Fal AI.


## OpenAPI

````yaml POST /generation/minimax/minimax-h3
openapi: 3.0.3
info:
  title: Pollo | AI Video Collection
  description: >-
    ✨RESTful API Document. Model discovery: GET /api/v1/model-specs (public,
    keyless).
  version: 1.0.0
servers:
  - url: https://pollo.ai/api/platform
security: []
externalDocs:
  url: https://pollo.ai/api/platform/api/openapi.json
paths:
  /generation/minimax/minimax-h3:
    post:
      tags:
        - generation
        - video generation
      summary: create video by text or image or reference image
      operationId: generation-minimax-h32video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  anyOf:
                    - allOf:
                        - {}
                        - type: object
                          properties:
                            image:
                              type: string
                              maxLength: 1000
                              format: uri
                              pattern: ^(?:http|https):\/\/
                              description: >-
                                Only image URLs are accepted (HTTPS preferred);
                                base64 is not allowed.
                                            Supported formats include JPG, PNG, and JPEG.
                                            Image aspect ratio must be less than 1:4 or 4:1.
                            imageTail:
                              type: string
                              maxLength: 1000
                              format: uri
                              pattern: ^(?:http|https):\/\/
                              description: |-
                                URL of the tail image for video generation.
                                            Only image URLs are accepted (HTTPS preferred); base64 is not allowed.
                                            Supported formats include JPG, PNG, and JPEG.
                                            Image aspect ratio must be less than 1:4 or 4:1.
                            prompt:
                              type: string
                              minLength: 1
                              maxLength: 7000
                              description: The prompt of the generation
                            resolution:
                              type: string
                              enum:
                                - 768P
                                - 2K
                              default: 2K
                              description: The resolution of the generation
                            length:
                              type: number
                              enum:
                                - 5
                                - 6
                                - 7
                                - 8
                                - 9
                                - 10
                                - 11
                                - 12
                                - 13
                                - 14
                                - 15
                              default: 5
                              description: The length of the generation
                            aspectRatio:
                              type: string
                              enum:
                                - Auto
                                - '21:9'
                                - '16:9'
                                - '4:3'
                                - '1:1'
                                - '3:4'
                                - '9:16'
                              default: Auto
                          required:
                            - image
                            - prompt
                          additionalProperties: false
                    - allOf:
                        - {}
                        - type: object
                          properties:
                            prompt:
                              type: string
                              minLength: 1
                              maxLength: 7000
                              description: The prompt of the generation
                            resolution:
                              type: string
                              enum:
                                - 768P
                                - 2K
                              default: 2K
                              description: The resolution of the generation
                            length:
                              type: number
                              enum:
                                - 5
                                - 6
                                - 7
                                - 8
                                - 9
                                - 10
                                - 11
                                - 12
                                - 13
                                - 14
                                - 15
                              default: 5
                              description: The length of the generation
                            aspectRatio:
                              type: string
                              enum:
                                - Auto
                                - '21:9'
                                - '16:9'
                                - '4:3'
                                - '1:1'
                                - '3:4'
                                - '9:16'
                              default: Auto
                          required:
                            - prompt
                          additionalProperties: false
                webhookUrl:
                  type: string
                clientSource:
                  type: string
                  minLength: 1
                  maxLength: 100
              required:
                - input
              additionalProperties: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  taskId:
                    type: string
                  status:
                    type: string
                    enum:
                      - waiting
                      - succeed
                      - failed
                      - processing
                required:
                  - taskId
                  - status
                additionalProperties: false
        default:
          $ref: '#/components/responses/error'
      security:
        - ApiKeyAuth: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key to authorize requests

````