Skip to main content

​
Overview

MiniMax H3 (Hailuo 3.0) is an omni-modal video model released by MiniMax on 2026-07-31 (UTC+8). A single model takes in text, images, video, and audio and outputs video with a stereo audio track. APIYI serves MiniMax-H3 from a self-hosted deployment of the open weights, at 768P, 4–15 seconds per clip, billed per second.
Highlights: one endpoint covers text-to-video, first-frame / last-frame / first-and-last-frame video, and mixed reference generation with up to 9 images, 3 videos, and 3 audio clips. Every clip comes with music and sound effects. $0.03 per second (the official MiniMax API charges $0.08), so a 10-second clip costs $0.30, and failed tasks are refunded automatically.

Video Generation API Reference

Create a task and query it by task_id, with Python / cURL / Node.js examples and a live Playground

Top-up Bonuses

Top-up bonuses lower the effective price further

​
Let an AI Agent Integrate It for You

If you build with Codex / Claude Code / Cursor, copy the prompt below into it. The agent first fetches the plain-text version of this page (append .md to any docs URL), then writes code for your stack. The common mistakes are already spelled out: the path needs /hailuo, results sit inside task, and duration must be an integer from 4 to 15.

Have a coding agent integrate or debug MiniMax-H3 video generation. Copy and paste it into Codex, Claude Code, Cursor, and similar tools.

​
Why APIYI’s MiniMax-H3?

Full capability set

Text, first/last-frame, and mixed image / video / audio reference generation are all available, with the same reference limits as the official model (9 images + 3 videos + 3 audio clips)

Per-second billing, refunds on failure

$0.03 per second, and you only pay for videos that succeed; failed tasks are refunded in full and submission errors are free

Top-up bonuses stack

Combine with top-up bonuses for a lower effective cost

Global access, no barriers

Connect directly to api.apiyi.com with one API Key; no overseas account needed

Full video model lineup

The same key also works with Seedance 2.0 / 2.5, Wan2.7, VEO 3.1, and more

Professional support

Contact support with integration questions; enterprise customers get hands-on onboarding

​
Key Features

Native stereo audio

Every clip includes music and sound effects driven by the prompt and any reference audio, with no dubbing step

7 aspect ratios

Six fixed ratios from 21:9 to 9:16, plus adaptive to follow the reference image

Any whole length from 4 to 15 s

Billed by the actual seconds requested, so short clips cost less

Long prompts

Up to 7000 characters per prompt, enough for shot-by-shot descriptions

First/last-frame control

Provide only the first frame, only the last frame, or both to set how the clip starts and ends

Multiple reference images

Up to 9 reference images; tag characters and objects in the prompt with <Picture 1> and so on

Motion transfer from video

Up to 3 reference videos to copy camera moves and motion rhythm

Audio-driven video

Up to 3 reference audio clips; the picture follows the music or voice

​
Pricing

This channel runs MiniMax’s open H3 weights on our own deployment. It is not a relay of the official MiniMax API, so it has its own pricing:
This channel is a self-hosted deployment of the open weights, priced independently of the official MiniMax API, and prices may change; the table above is for reference only, and the Model Pricing tab in the top navigation is authoritative: Model Pricing. Official prices from platform.minimax.io/docs/guides/pricing-paygo (retrieved 2026-09-29).
Billing details:
  • Billed by the requested duration in seconds, pre-charged when the task is accepted
  • No extra charge for reference media: reference images (up to 9), videos, and audio don’t change the price; only duration is billed
  • Failed tasks (media download failure, unsupported format, execution failure, etc.) are refunded in full automatically
  • Requests that return 4xx / 5xx at submission are not billed; querying and downloading are free
  • See top-up bonuses for a lower effective cost

​
Group Setup

MiniMax-H3 works in the default group, and the svip group works too; no dedicated group is needed. We recommend setting the Token’s billing model to Pay-as-you-go Priority. If a call returns “no available channels for the current group”, the Token’s group does not include this model or the model value is misspelled (it is case-sensitive).

​
Technical Specs

The official MiniMax H3 model supports 2K, but this channel only offers 768P; 2K is rejected.

​
API Endpoints

Primary host https://api.apiyi.com, backup host https://vip.apiyi.com, same paths. Note that the paths start with /hailuo, not /v1.

​
Generation Modes

The generation mode is inferred from the media in content[]:

​
Referring to media in the prompt

Each media type is numbered by its order in content[]: the first and second reference images are <Picture 1> and <Picture 2>, the first reference video is <Video 1>, the first reference audio clip is <Audio 1>. For example:
  • First/last frames cannot be combined with any reference media
  • With a single image you can omit role (it is treated as the first frame); with two or more images, set role on each
  • The combined length of reference videos cannot exceed 15 seconds, otherwise the task fails (and is refunded); a single clip over 15 seconds is trimmed to its first 15 seconds

​
Best Practices

1

Test with 4–5 seconds first

Billing is per second, so confirm composition and style with a short clip before rendering 10–15 seconds
2

Use a fixed ratio for text-to-video

16:9 for landscape, 9:16 for portrait, 21:9 for widescreen; with a first frame, adaptive keeps the image’s ratio
3

Host media on stable public storage

Use direct links from your own object storage or CDN so hotlink protection or expired signatures don’t break media downloads
4

Describe camera moves and sound

Cover the subject, action, camera movement, lighting, and the music and sound effects you want; the model generates them together
5

Poll every 10 seconds

Generation usually takes 2–4 minutes; set the overall client timeout to 15 minutes
6

Handle idempotency yourself

Keep a mapping from business ID to task_id; if a submission times out, look for an existing task before submitting again
7

Store the video right away

Download task.content.url with GET and serve it from your own storage

​
Error Codes & Retries

Client tips: set the submit timeout to 60 seconds (at peak times submission alone can take more than 10 seconds); only retry HTTP 500s and network errors, with backoff. Every run-stage failure is refunded automatically, and resubmitting creates a new charge.

​
FAQ

The path is missing the /hailuo prefix. The correct paths are /hailuo/v2/video_generation and /hailuo/v2/query/video_generation/{task_id}.
This channel supports 768P only. The official MiniMax model supports 2K, but this channel does not offer it.
No. duration is an integer from 4 to 15.
Every clip includes a stereo audio track, and there is no parameter to disable it. Strip the track in post-processing if you don’t need it.
Not at the moment. Resubmitting with the same Idempotency-Key still creates a new task that is billed separately. Track submitted tasks in your own application.
No. Once a task reaches failed it is refunded in full automatically; requests rejected at submission are not billed either.
No. All media must be public HTTPS URLs. Upload to your own object storage first and pass the link.
It follows the input image’s aspect ratio, e.g. 768×768 for a square image and 1344×768 for a 16:9 image. Text-only and audio-only requests cannot use adaptive.
A single clip over 15 seconds is trimmed to its first 15 seconds automatically, but if several reference videos add up to more than 15 seconds the task fails (and is refunded).
The measured median is about 3 minutes, usually 2–4 minutes; 10–15 second clips take a bit longer.
We have not seen it expire quickly, but long-term availability is not guaranteed, so download and store the video promptly. Check the URL with GET; HEAD requests return 403.
First confirm the request body follows the rules (exactly one text item, no extra fields, https media links). If it does, it is usually transient overload: wait a few seconds and retry. Failed submissions are not billed.