Video Official partner

Hailuo 02 API

Hailuo 02 with end-frame support.

1080P
Max resolution: 10s
Max clip length: ~95s
Avg. generation: 34 credits
From

Video · made with Hailuo 03 (MiniMax H3)

A jazz drummer mid-solo in a smoky club, a man in his 40s with short salt-and-pepper hair, cream shirt with rolled sleeves, gold watch, vintage Gretsch kit. Brushes on the snare, warm tungsten light, slow push-in from the crowd, stereo room ambience with the kit panned naturally. Photoreal 2K, 35mm.

Playground

Try Hailuo 02 right here.

model: hailuo-02

Prompt

Duration Resolution

Media inputs

Reference image End image

Advanced settings

Optimize prompt Let Hailuo rewrite your prompt for better results.

Estimated cost 34–60 credits · $0.34–$0.60 Generate in Studio

Output Example · Hailuo 03 (MiniMax H3)

Pricing

Simple per-generation pricing.

34–60 credits per generation ≈ $0.34–$0.60

The rate depends on the resolution and options you pick.

You only pay for successful generations. Failed jobs are refunded automatically.
One credit balance across every model on Apiframe, no per-model plans.
Start with free credits. No subscription required.
Volume discounts on larger plans.

See plans and credit packs

Specs

At a glance.

Provider MiniMax

Model ID hailuo-02

Resolutions 768p, 1080p

Durations 6s, 10s

Image input Supported

Avg. time ~95s

Quickstart

How to call the Hailuo 02 API.

Send one POST /v2/videos/generate request with your API key. The call returns a jobId you can poll, or pass a webhook_url and the result is pushed to you the moment it's ready.

Swap hailuo-02 for any other model and nothing else changes.

Get API key Read the docs

generate.js

const response = await fetch("https://api.apiframe.ai/v2/videos/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
    "model": "hailuo-02",
    "hailuoParams": {
      "image": "https://example.com/input.jpg",
      "resolution": "768p",
      "end_image": "https://example.com/input.jpg",
      "prompt_optimizer": true
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/videos/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "hailuo-02",
        "hailuoParams": {
            "image": "https://example.com/input.jpg",
            "resolution": "768p",
            "end_image": "https://example.com/input.jpg",
            "prompt_optimizer": True
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/videos/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a cinematic sunrise over a futuristic cityscape, smooth camera push-in",
        "model": "hailuo-02",
        "hailuoParams": {
            "image": "https://example.com/input.jpg",
            "resolution": "768p",
            "end_image": "https://example.com/input.jpg",
            "prompt_optimizer": true
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

Input schema

Every field Hailuo 02 accepts, with types and defaults. The full reference lives in the docs.

Field	Type	Description
prompt required	string	Text description of what to generate.
model required	string	The model identifier for this endpoint. Default:"hailuo-02" · "hailuo-02"
hailuoParams.image	string (URL)	Use a still as the first frame.
hailuoParams.resolution	string	Resolution Default:"768p" · "768p", "1080p"
hailuoParams.end_image	string (URL)	Optional last frame to control the ending.
hailuoParams.prompt_optimizer	boolean	Let Hailuo rewrite your prompt for better results. Default:true

The Hailuo flagship

Hailuo 02 is one of 4 Hailuo video models on Apiframe. The full editorial page (showcase, comparison, and use cases) lives on the flagship.

Flagship from 10 cr/s Hailuo 03 (MiniMax H3)

768p / 2K video with stereo sound.

Explore Hailuo 03 (MiniMax H3) All video models

Hailuo 02 questions

What teams ask before shipping with Hailuo 02. Everything else lives in the docs.

Is there an API for Hailuo 02?

Yes. Apiframe exposes Hailuo 02 through a single REST endpoint (POST /v2/videos/generate with model: "hailuo-02"). You get one unified API, key, and billing across every supported model, with no separate MiniMax account required.

How much does the Hailuo 02 API cost?

Hailuo 02 uses simple pay-as-you-go pricing on Apiframe. You only pay for successful generations. See the pricing page for plans and volume discounts.

How do I call the Hailuo 02 API?

Send a POST request to /v2/videos/generate with your X-API-Key and a JSON body containing model: "hailuo-02". The call returns a jobId; poll GET /v2/jobs/{id} or use a webhook to receive the result.

What parameters does Hailuo 02 support?

Hailuo 02 accepts 4 model-specific parameters (nested under hailuoParams) plus the common prompt and webhook_url fields. See the input schema above for the full list with types and defaults.