MiniMax H3
hailuo/minimax-h3MiniMax H3 (Hailuo 03) is a unified multimodal video generation model that turns text, images, video, and audio references into polished 2K videos with native stereo sound. Build original scenes, animate stills, edit existing footage, and run it all through one MiniMax H3 API.
Overview
MiniMax H3 (Hailuo 03) is a unified multimodal video generation model that turns text, images, video, and audio references into polished 2K videos with native stereo sound. Build original scenes, animate stills, edit existing footage, and run it all through one MiniMax H3 API.
Authentication
All API requests require a valid API key passed via the Authorization header using the Bearer scheme.
Quickstart
Credentials
Set the RUNBASE_API_KEY environment variable.
export RUNBASE_API_KEY=your-api-keyCreate a run
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'Runs
Runs are processed asynchronously. Submit a request, then poll for the result.
Create a run
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'Get run status
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Get result
Poll the status endpoint until status is "succeeded", then read output.urls from the response.
Input Schema
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | Required | PromptUp to 7000 characters |
| aspect_ratio | string | Optional | Aspect ratioOptions: 16:99:161:14:33:421:9Default: 16:9 |
| resolution | string | Optional | 2K requires at least one reference image; text-only generation supports 768p only.Options: 768p2kDefault: 768p |
| duration | number | Optional | Duration (seconds)Range: 4–15Default: 5 |
| image_urls | string[] | Optional | Reference imagesUp to 5 images |
Output Schema
| Field | Type | Description |
|---|---|---|
| urls | string[] | Generated output URLs |
Errors
The API uses standard HTTP status codes to indicate success or failure.
| Status Code | Description |
|---|---|
| 400 | Invalid request - missing or malformed parameters |
| 401 | Authentication failed - missing or invalid API key |
| 402 | Insufficient credits |
| 403 | Forbidden - IP not allowed, account banned, or API key credit limit exceeded |
| 404 | Run not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |

