Use the Hailuo API via RunAPI with a model skill, unified auth, and pay-as-you-go pricing.
curl -X POST https://runapi.ai/api/v1/hailuo/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_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 6-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 6-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 6-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 6-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 cursorHailuo 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.
| Variant | Billing | Pricing | |
|---|---|---|---|
| hailuo-02-image-to-video-pro | call | $0.570 | View → |
| hailuo-02-image-to-video-standard | call | $0.500 | 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 → |
| Endpoint | Resolution | Duration | Price | |
|---|---|---|---|---|
| image_to_video | — | — | $0.57 / video |
Prices shown for hailuo-02-image-to-video-pro. Other variants retain their own endpoint pricing.
Sign up and generate an API key from the dashboard.
Choose the version that best matches your quality and cost requirements.
Submit your prompt and parameters to the model's documented endpoint.
Poll the task or set a webhook, then download the completed output.
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.
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.
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.
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.
Native 1080p on pro variants. Standard variants output up to 768p, with Hailuo 2.3 standard reaching 1080p. No post-process upscaling needed for the pro tier.
Up to 10 seconds per generation for both text-to-video and image-to-video endpoints.
Hailuo is specifically trained for accurate physics — fluid dynamics, object collisions, gravity, and cloth movement render with high fidelity.
Pro outputs at native 1080p with better detail and motion fidelity. Standard outputs up to 768p (Hailuo 2.3 standard reaches 1080p) and costs roughly 50% less.
Yes — 2.3 adds improved body motion, micro-expressions, and dedicated anime/illustration styles not available in the 02 generation.
Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production.