Video · MiniMax

Hailuo API

Hailuo API access for text and image-to-video at native 1080p with accurate physics simulation and motion.

Operational · 6 variants · from $0.300

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-2.3-image-to-video-standard",
  "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-2.3-image-to-video-standard",
    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.",
});

<?php

require __DIR__ . "/vendor/autoload.php";

use RunApi\Hailuo\HailuoClient;

$client = new HailuoClient();
$result = $client->imageToVideo->run([
        'model' => 'hailuo-2.3-image-to-video-standard',
        '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-2.3-image-to-video-standard",
    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."
)

npx skills add runapi-ai/hailuo -g

# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

# Codex
codex plugin install runapi-mcp@agents

# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor

@runapi.ai/hailuo v1

OVERVIEW

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.

Multiple variants for different speed, quality, and cost tiers
Model skill includes docs, schemas, pricing, and setup notes
Works with Claude Code, Codex, Gemini CLI, Cursor, and VS Code
Single API key and unified billing across all variants
Async task management with polling and webhook callbacks
Failed generations are not charged

VARIANTS

Compare all API variants

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

SKILLS

Install the Hailuo skill for app development

Load the model docs, schemas, pricing notes, and setup steps into your coding workspace.

# Install the model skill for app development workflows
npx skills add runapi-ai/hailuo -g

Installs docs, schemas, pricing context, and setup notes into your developer workspace.

Or use this setup request in your coding tool:

Install the Hailuo skill for this app:

1. Add runapi-ai/hailuo with the skills installer.
2. Load SKILL.md in this workspace.
3. Use its docs, schemas, pricing notes, and setup steps when adding model features.
4. Confirm the install path when done.

OpenClaw

Use Hailuo in OpenClaw

Prompt, curl command, parameters, and FAQ.

Hermes Agent

Use Hailuo in Hermes Agent

Custom provider setup, API call, and FAQ.

HOW IT WORKS

From model skill to first result in four steps

Choose a model

Browse the model catalog and pick the model and variant that match your output type, quality bar, and latency target. Each variant page shows its model ID, pricing, and parameter constraints so you can compare before committing.

Configure

Set your RunAPI API key as an environment variable and install the model skill in your coding workspace. The skill loads docs, typed schemas, pricing notes, and setup steps so your agent has the right context from the start.

Call

Use the skill instructions to add the model feature inside your application. Send a POST request with your prompt, model ID, and parameters. RunAPI routes the request, manages the async lifecycle, and returns structured JSON.

Receive

Poll by task ID for completion, stream results end-to-end when supported, or configure a webhook callback URL to receive results automatically. The CLI provides a built-in wait command, and the SDKs offer both polling and callback patterns.

CONTEXT

What is the Hailuo API?

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

WHY RUNAPI

Why route the Hailuo API through RunAPI

One auth, every provider

A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter.

Unified pricing & billing

Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model.

Schema-first SDK

Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code.

FAQ