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

# MiniMax H3

> Text-to-video, first/last-frame generation, and multimodal references.



## OpenAPI

````yaml en/openapi/videos/minimax-h3.yaml POST /v1/videos/generate
openapi: 3.1.0
info:
  title: MiniMax H3
  version: '1.0'
  description: Text-to-video, first/last-frame generation, and multimodal references.
servers:
  - url: https://openapi.imini.ai/imini/router
security:
  - ApiKeyAuth: []
paths:
  /v1/videos/generate:
    post:
      summary: MiniMax H3
      description: >
        - Keyframes: send `first_frame` with optional `last_frame`. Do not mix
        with ordinary references.

        - Generates synchronized audio. No audio toggle, audio-only references,
        or video editing.

        - Reference video: MP4 or MOV, up to 50 MB per clip. Reference audio:
        WAV or MP3, up to 15 MB per clip. Each clip is 2–15 seconds; each media
        type is limited to 15 seconds total.


        After submission, [poll the task](/en/api-reference/videos/task-query).
        See [pricing](/en/guide/pricing).
      operationId: generateMinimaxH3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              properties:
                model:
                  type: string
                  const: minimax-h3
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 7000
                  description: Video prompt.
                resolution:
                  type: string
                  enum:
                    - 768P
                    - 2K
                  default: 768P
                  description: Output resolution.
                duration:
                  type: integer
                  minimum: 4
                  maximum: 15
                  default: 4
                  description: Output duration in seconds.
                aspect_ratio:
                  type: string
                  enum:
                    - '21:9'
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                  default: '16:9'
                  description: Output aspect ratio.
                reference_images:
                  type: array
                  maxItems: 9
                  description: References or keyframes.
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: >-
                          Public HTTP(S) JPG/JPEG/PNG/WebP/HEIC/HEIF URL or a
                          JPEG/PNG/WebP Base64 Data URI (up to 20 MiB decoded).
                      reference_type:
                        type:
                          - string
                          - 'null'
                        enum:
                          - asset
                          - first_frame
                          - last_frame
                          - null
                        default: asset
                        description: '`null` is treated as `asset`.'
                reference_videos:
                  type: array
                  maxItems: 3
                  description: '`asset` references only; no edit source.'
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: >-
                          Public HTTP(S) MP4 or MOV URL. Base64 video is not
                          supported.
                      reference_type:
                        type:
                          - string
                          - 'null'
                        enum:
                          - asset
                          - null
                        default: asset
                      keep_original_sound:
                        type: boolean
                        description: Keep the original audio track.
                reference_audios:
                  type: array
                  maxItems: 3
                  description: Audio requires a reference image or video.
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: >-
                          Public HTTP(S) WAV or MP3 URL, or a Base64 Data URI of
                          the same format (up to 15 MiB decoded).
                      reference_type:
                        type:
                          - string
                          - 'null'
                        enum:
                          - asset
                          - null
                        default: asset
                        description: Ordinary audio reference.
            examples:
              text:
                summary: Text to video
                value:
                  model: minimax-h3
                  resolution: 768P
                  duration: 4
                  prompt: A slow forward camera move over a bay in the morning mist.
                  aspect_ratio: '16:9'
              first_frame:
                summary: First-frame generation
                value:
                  model: minimax-h3
                  resolution: 768P
                  duration: 4
                  prompt: Let the clouds drift slowly while the camera remains steady.
                  reference_images:
                    - url: https://example.com/first.png
                      reference_type: first_frame
              first_last:
                summary: First and last frames
                value:
                  model: minimax-h3
                  resolution: 768P
                  duration: 4
                  prompt: Make a smooth transition between the first and last frame.
                  reference_images:
                    - url: https://example.com/first.png
                      reference_type: first_frame
                    - url: https://example.com/last.png
                      reference_type: last_frame
              reference:
                summary: Mixed references
                value:
                  model: minimax-h3
                  resolution: 768P
                  duration: 4
                  prompt: >-
                    Use the image for composition and the video as a guide for
                    camera movement.
                  reference_images:
                    - url: https://example.com/reference.png
                      reference_type: asset
                  reference_videos:
                    - url: https://example.com/motion.mp4
                      reference_type: asset
                  reference_audios:
                    - url: https://example.com/audio.mp3
                      reference_type: asset
      responses:
        '200':
          description: Task accepted.
          content:
            application/json:
              schema:
                type: object
                required:
                  - task_id
                  - model
                  - created_at
                  - request_id
                properties:
                  task_id:
                    type: string
                    description: Task ID to poll.
                  model:
                    type: string
                    description: Echoes the supplied model ID.
                  created_at:
                    type: string
                    format: date-time
                    description: Task creation time (UTC).
                  request_id:
                    type: string
                    description: Request ID.
              example:
                task_id: task_2041350318103396352
                model: minimax-h3
                created_at: '2026-11-16T07:00:00.000Z'
                request_id: task_2041350318103396352
        '400':
          description: Invalid model or request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              example:
                error:
                  code: INVALID_PARAMETER
                  message: Parameter value is out of range or has incorrect type
                  status: 400
                  request_id: req_example
        '402':
          description: Insufficient credits.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              example:
                error:
                  code: INSUFFICIENT_CREDITS
                  message: >-
                    Insufficient credits. Upgrade your plan or purchase
                    additional credits.
                  status: 402
                  request_id: req_example
        '413':
          description: Request body or Base64 media exceeds a size limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              example:
                error:
                  code: PAYLOAD_TOO_LARGE
                  message: Request payload exceeds the supported size
                  status: 413
                  request_id: req_example
components:
  schemas:
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - status
          properties:
            code:
              type: string
            message:
              type: string
            status:
              type: integer
            request_id:
              type: string
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        `Bearer YOUR_API_KEY`. Manage keys in [API
        Keys](https://imini.ai/api-keys).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.