Video · MiniMax

Hailuo

Text and image-to-video at native 1080p with accurate physics simulation and motion.

Operational · 6 variants · à partir de $0.300
# Works with Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents
npx skills add runapi-ai/hailuo -g
The -g flag installs globally so every project picks it up.
Or paste this prompt to your AI agent:
Install the Hailuo skill for me:

1. Clone https://github.com/runapi-ai/hailuo
2. Copy the skills/hailuo/ directory into your
   user-level skills directory (e.g. ~/.claude/skills/
   for Claude Code, ~/.codex/skills/ for Codex).
3. Verify that SKILL.md is present.
4. Confirm the install path when done.
APERÇU

Hailuo is MiniMax's video generation model capable of producing native 1080p footage with realistic physics simulation. It supports both text-to-video and image-to-video generation in standard and pro quality tiers.

  • Installable agent skill
  • Unified API key
  • SDK examples included
  • Les générations échouées ne sont pas facturées
VARIANTES

Variantes

Variant Billing From
hailuo-02-image-to-video-pro call $0.570 Voir →
hailuo-02-image-to-video-standard call $0.300 Voir →
hailuo-02-text-to-video-pro call $0.570 Voir →
hailuo-02-text-to-video-standard call $0.500 Voir →
hailuo-2.3-image-to-video-pro call $0.900 Voir →
hailuo-2.3-image-to-video-standard call $0.500 Voir →
AGENT USAGE

Use this model from your agent

Prompt + SDK example
# User prompt to the agent
"Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge."
// Code generated by the agent via @runapi.ai/hailuo
import { HailuoClient } from '@runapi.ai/hailuo';

const client = new HailuoClient();
const result = await client.imageToVideo.run({
  model: 'hailuo-02-image-to-video-pro',
  prompt: 'Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge.',
});
@runapi.ai/hailuo npm
FONCTIONNEMENT

How to call this model

01

Install the skill

Add the model skill to your agent or install the SDK package.

02

Authenticate once

Use your RunAPI key for every supported model.

03

Send a request

Use the unified schema for the endpoint you need.

04

Receive output

Poll by task ID or handle the callback when the generation completes.

SDK QUICKSTART

SDK quickstart

runapi.ai
curl -X POST https://runapi.ai/api/v1/hailuo/image_to_video \
  -H "Authorization: Bearer $RUNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-02-image-to-video-pro",
  "image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
  "prompt": "Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge."
}'
import { HailuoClient } from "@runapi.ai/hailuo";

const client = new HailuoClient();
const result = await client.imageToVideo.run({
    model: "hailuo-02-image-to-video-pro",
    image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
    prompt: "Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge.",
});
require "runapi/hailuo"

client = RunApi::Hailuo::Client.new
result = client.image_to_video.run(
    model: "hailuo-02-image-to-video-pro",
    image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
    prompt: "Generate a 5-second clip of a glass marble rolling across a wooden desk and falling off the edge."
)
@runapi.ai/hailuo v1
CONTEXTE

Where Hailuo fits

Hailuo is MiniMax's video model, known for accurate physics and motion fidelity at native 1080p. Through RunAPI, standard and pro variants share a single key.

Provider
MiniMax
Modality
Video
POURQUOI RUNAPI

Why use Hailuo through RunAPI

One API key

Use the same credentials across models and providers.

Agent-ready

Installable skills include docs and schema for tool calls.

Predictable billing

Usage-based pricing is visible before you call.

FAQ

Frequently asked questions

How do I call this model?

Use the RunAPI SDK, CLI, or REST endpoint shown on this page.

Do failed generations cost money?

Les générations échouées ne sont pas facturées

Can agents use it directly?

Yes. Install the model skill and your agent gets the docs, schema, and examples.

COMMENCER

Start building with Hailuo.