Runbase

Command Palette

Search for a command to run...

Hailuo

MiniMax H3

ID:hailuo/minimax-h3

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.

MiniMax H3Hailuo 03Text to Video2K VideoNative AudioVideo Editing

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.

Shell
export RUNBASE_API_KEY=your-api-key

Create a run

Shell
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

Shell
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

Shell
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

ParameterTypeRequiredDescription
promptstringRequiredPromptUp to 7000 characters
aspect_ratiostringOptionalAspect ratioOptions: 16:99:161:14:33:421:9Default: 16:9
resolutionstringOptional2K requires at least one reference image; text-only generation supports 768p only.Options: 768p2kDefault: 768p
durationnumberOptionalDuration (seconds)Range: 4–15Default: 5
image_urlsstring[]OptionalReference imagesUp to 5 images

Output Schema

FieldTypeDescription
urlsstring[]Generated output URLs

Errors

The API uses standard HTTP status codes to indicate success or failure.

Status CodeDescription
400Invalid request - missing or malformed parameters
401Authentication failed - missing or invalid API key
402Insufficient credits
403Forbidden - IP not allowed, account banned, or API key credit limit exceeded
404Run not found
429Rate limit exceeded
500Internal server error