> ## 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 Ref API Documentation

> MiniMax H3 Ref API generates reference-guided videos that lock character identity, style, and scene details across multi-shot sequences. Feed images as creative anchors to keep visual continuity while producing videos with native synced audio. Integrate the MiniMax H3 Ref API now.

Check out MiniMax H3 Ref 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/ref2video
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/ref2video:
    post:
      tags:
        - generation
        - video generation
      summary: create reference video
      operationId: generation-minimax-h3/ref2video
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  properties:
                    prompt:
                      type: string
                      minLength: 1
                      maxLength: 7000
                      description: The prompt of the generation
                    duration:
                      type: number
                      enum:
                        - 5
                        - 6
                        - 7
                        - 8
                        - 9
                        - 10
                        - 11
                        - 12
                        - 13
                        - 14
                        - 15
                      default: 5
                    resolution:
                      type: string
                      enum:
                        - 768P
                        - 2K
                      default: 2K
                      description: The resolution of the generation
                    aspectRatio:
                      type: string
                      enum:
                        - Auto
                        - '21:9'
                        - '16:9'
                        - '4:3'
                        - '1:1'
                        - '3:4'
                        - '9:16'
                      default: Auto
                    videoNum:
                      type: number
                      minimum: 1
                      maximum: 4
                      default: 1
                    imageMeta:
                      type: array
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                          url:
                            type: string
                            maxLength: 1000
                            format: uri
                            pattern: ^(?:http|https):\/\/
                            description: Original image URL
                          order:
                            type: number
                            minimum: 0
                            maximum: 10
                            description: Image order
                          cropper:
                            type: object
                            properties:
                              url:
                                type: string
                                maxLength: 1000
                                format: uri
                                pattern: ^(?:http|https):\/\/
                                description: Cropped image URL
                              detail:
                                type: object
                                properties:
                                  x:
                                    type: number
                                  'y':
                                    type: number
                                  width:
                                    type: number
                                  height:
                                    type: number
                                  rotate:
                                    type: number
                                  scaleX:
                                    type: number
                                  scaleY:
                                    type: number
                                required:
                                  - x
                                  - 'y'
                                  - width
                                  - height
                                  - rotate
                                  - scaleX
                                  - scaleY
                                additionalProperties: false
                              height:
                                type: number
                              width:
                                type: number
                            required:
                              - url
                              - detail
                              - height
                              - width
                            additionalProperties: false
                        required:
                          - url
                          - order
                        additionalProperties: false
                    refs:
                      type: array
                      items:
                        anyOf:
                          - type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - image
                              name:
                                type: string
                                maxLength: 64
                              image:
                                type: string
                                maxLength: 1000
                                format: uri
                                pattern: ^(?:http|https):\/\/
                              order:
                                type: number
                                minimum: 1
                              avatarId:
                                type: string
                            required:
                              - type
                              - name
                              - image
                              - order
                            additionalProperties: false
                          - type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - subject
                              name:
                                type: string
                                maxLength: 64
                              images:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    url:
                                      type: string
                                      maxLength: 1000
                                      format: uri
                                      pattern: ^(?:http|https):\/\/
                                    order:
                                      type: number
                                      minimum: 1
                                  required:
                                    - url
                                    - order
                                  additionalProperties: false
                                minItems: 1
                                maxItems: 3
                              subjectId:
                                type: string
                            required:
                              - type
                              - name
                              - images
                              - subjectId
                            additionalProperties: false
                          - type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - video
                              name:
                                type: string
                                maxLength: 64
                              video:
                                type: string
                                maxLength: 1000
                                format: uri
                                pattern: ^(?:http|https):\/\/
                              order:
                                type: number
                                minimum: 1
                            required:
                              - type
                              - name
                              - video
                              - order
                            additionalProperties: false
                          - type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - audio
                              name:
                                type: string
                                maxLength: 64
                              audio:
                                type: string
                                maxLength: 1000
                                format: uri
                                pattern: ^(?:http|https):\/\/
                              order:
                                type: number
                                minimum: 1
                            required:
                              - type
                              - name
                              - audio
                              - order
                            additionalProperties: false
                      minItems: 1
                      maxItems: 15
                    unlimited:
                      type: boolean
                  required:
                    - prompt
                    - refs
                  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

````