MiniMax H3 Video Generation

curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "minimax_h3_task_123456"
  }'

{
  "out_task_id": "<string>",
  "status": "<string>",
  "estimated_credits": 123,
  "created_at": "<string>"
}

POST

api

openapi

submit

curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "minimax_h3_task_123456"
  }'

{
  "out_task_id": "<string>",
  "status": "<string>",
  "estimated_credits": 123,
  "created_at": "<string>"
}

The model name of MiniMax H3 in AIReiter is minimax_h3. This model is also commonly searched as Hailuo 03, Hailuo 3, or the MiniMax H3 API.

Authorizations

string

required

All endpoints require Bearer Token authentication.Get the API Key:Visit the API Key management page to get your API Key.When using it, add the following to the request header:

Authorization: Bearer YOUR_API_KEY

Body

string

required

Model name, fixed value:

minimax_h3

object

required

Model parameters object.

Show Properties of the params object

string

required

Text description for video generation, up to 7000 characters.You can describe the subject, scene, camera movement, action, style, lighting, rhythm, and more.

string

default:"text_to_video"

Generation type, which determines which video generation mode to use.

text_to_video - Text-to-video, generates a video using only the prompt
first_last_frame - First-frame/last-frame image-to-video, generates a video using the first frame, last frame, or a transition between them
all_reference - Generate video from multiple reference materials, can use reference images, reference videos, and reference audio

number

default:"4"

Video duration, in seconds.Integer values supported: 4 to 15.

string

default:"2k"

Output quality:

768p
2k

string

default:"16:9"

Video aspect ratio.Supported aspect ratios:

21:9 - Ultra-wide
16:9 - Landscape, default value
4:3 - Standard landscape
1:1 - Square
3:4 - Standard portrait
9:16 - Portrait

first_last_frame mode does not support selecting the aspect ratio separately; the output will follow the input image ratio.

string | string[]

Image URL.The meaning varies by type:

text_to_video - No image needs to be passed
first_last_frame - Used as the first-frame image; you can also pass an array, with the first image as the first frame and the second image as the last frame
all_reference - Used as reference images, up to 9 images

Image requirements:

Supports JPG, JPEG, PNG, WEBP, HEIC, HEIF
Maximum size for a single image is 30MB
Width and height range: 256-5760px
Image aspect ratio range: 0.4-2.5

string

Last-frame image URL.Only valid in first_last_frame mode. You can also pass the last frame as the second image in the image_url array.

string | string[]

Reference video URL.Only valid in all_reference mode.Currently, up to 1 reference video is supported.Video requirements:

Single video duration: 2-15 seconds
Supports MP4, MOV
Video encoding: H.264 or H.265
Audio encoding: AAC or MP3
Maximum size for a single video is 50MB
Width and height range: 256-5760px
Frame rate: 23.976-60 FPS

Please ensure the URL is publicly accessible and that the video duration metadata can be read.

string | string[]

Reference audio URL.Only valid in all_reference mode, with up to 3 audio files.Audio requirements:

Single audio duration: 2-15 seconds
Supports WAV, MP3
Maximum size for a single audio file is 15MB

string

required

Initiator task ID.A user-defined task identifier, required. You can use this ID later to query the task status and results.

Response

string

Originator task ID, used to query the result.

string

Initial status, usually "pending".

number

Estimated credits consumed.

string

Creation time, in ISO format.

Query Task

MiniMax H3 is an asynchronous video generation model. After submitting a task, use out_task_id to query the task status.

string

required

The initiator task ID passed in when submitting the task.

curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "minimax_h3_task_123456"
  }'

After the query succeeds and is completed, the output field in the Response will contain the generated video URL.

Request Examples

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "minimax_h3",
    "params": {
      "prompt": "A lone traveler walks along a windswept cliff at golden hour, cinematic tracking shot",
      "type": "text_to_video",
      "video_length": 5,
      "quality": "2k",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "minimax_h3_text_123456"
  }'

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "minimax_h3",
    "params": {
      "prompt": "Smooth transition between the two framings, gentle wind, subtle camera push-in",
      "type": "first_last_frame",
      "image_url": [
        "https://example.com/first.jpg",
        "https://example.com/last.jpg"
      ],
      "video_length": 6,
      "quality": "2k"
    },
    "out_task_id": "minimax_h3_frame_123456"
  }'

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "minimax_h3",
    "params": {
      "prompt": "Create a polished ecommerce product video with consistent product appearance and cinematic motion",
      "type": "all_reference",
      "image_url": [
        "https://example.com/product-front.jpg",
        "https://example.com/product-lifestyle.jpg"
      ],
      "video_url": ["https://example.com/motion-reference.mp4"],
      "audio_url": ["https://example.com/music-reference.mp3"],
      "video_length": 5,
      "quality": "2k",
      "aspect_ratio": "16:9"
    },
    "out_task_id": "minimax_h3_reference_123456"
  }'

import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "minimax_h3",
    "params": {
        "prompt": "A cinematic product video with soft studio lighting",
        "type": "text_to_video",
        "video_length": 5,
        "quality": "2k",
        "aspect_ratio": "16:9"
    },
    "out_task_id": "minimax_h3_python_123456"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://aireiter.com/api/openapi/submit", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "minimax_h3",
    params: {
      prompt: "A cinematic product video with soft studio lighting",
      type: "text_to_video",
      video_length: 5,
      quality: "2k",
      aspect_ratio: "16:9"
    },
    out_task_id: "minimax_h3_js_123456"
  })
});

const data = await response.json();
console.log(data);

Mode Notes

The text_to_video mode invokes MiniMax H3 text-to-video capabilities; the first_last_frame mode invokes image-to-video capabilities; the all_reference mode invokes multi-reference asset generation capabilities.

When type is first_last_frame, do not rely on the aspect_ratio parameter. The output aspect ratio in this mode is determined by the input image.

Overview

Image Series

Video Series

Audio Series

Text Series

Task Management

MiniMax H3 Video Generation

Authorizations

Body

Response

Query Task

Request Examples

Mode Notes

​Authorizations

​Body

​Response

​Query Task

​Request Examples

​Mode Notes

Authorizations

Body

Response

Query Task

Request Examples

Mode Notes