Hailuo API
Text and image-to-video at native 1080p with accurate physics simulation and motion.
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 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.
- Meerdere varianten voor verschillende snelheid-/kwaliteitsniveaus
- Modelskill bevat docs, schema's en setupnotities
- Werkt met appgerichte codeerworkflows
- Mislukte generaties worden niet in rekening gebracht
Vergelijk alle API-varianten
| Variant | Billing | From | |
|---|---|---|---|
| hailuo-02-image-to-video-pro | call | $0.570 | Bekijken → |
| hailuo-02-image-to-video-standard | call | $0.300 | Bekijken → |
| hailuo-02-text-to-video-pro | call | $0.570 | Bekijken → |
| hailuo-02-text-to-video-standard | call | $0.500 | Bekijken → |
| hailuo-2.3-image-to-video-pro | call | $0.900 | Bekijken → |
| hailuo-2.3-image-to-video-standard | call | $0.500 | Bekijken → |
Installeer de Hailuo skill voor appontwikkeling
Laad modeldocs, schema's, prijsnotities en setupstappen in je codeworkspace.
# Install the model skill for app development workflows
npx skills add runapi-ai/hailuo -gInstall 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.
Van modelskill naar eerste resultaat in vier stappen
Kies het model
Kies het model en de variant die passen bij je outputtype, kwaliteitslat en latencydoel.
Configureren
Stel je RunAPI-key in en installeer de modelskill in je codeworkspace.
Bouwen
Gebruik de skill-instructies om de modelfeature in je applicatie toe te voegen.
Ontvangen
Poll op task-ID, stream wanneer ondersteund of verwerk de webhook-callback.
Wat is de 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.
Waarom de Hailuo API via RunAPI gebruiken
Eén auth, elke provider
Met één RunAPI-sleutel ontgrendel je de hele catalogus. Geen aparte accounts, geen sleutelrotatie per integratie.
Uniforme prijzen & billing
Prijs per call in USD, maandelijks gefactureerd. Mislukte generaties worden niet in rekening gebracht.
Skill met schema's
Getypeerde schema's en setupnotities zitten in de modelskill, zodat implementatie start vanuit het juiste contract.
Veelgestelde vragen
What resolution does Hailuo output?
Native 1080p op pro-varianten. Standaardvarianten leveren tot 768p, waarbij Hailuo 2.3 standard 1080p bereikt. Geen post-process upscaling nodig voor de pro-tier.
How long are generated clips?
Up to 10 seconds per generation for both text-to-video and image-to-video endpoints.
How realistic is the physics simulation?
Hailuo is specifically trained for accurate physics — fluid dynamics, object collisions, gravity, and cloth movement render with high fidelity.
What is the difference between standard and pro?
Pro levert native 1080p met betere details en bewegingsgetrouwheid. Standard levert tot 768p (Hailuo 2.3 standard bereikt 1080p) en kost ongeveer 50% minder.
Does Hailuo 2.3 improve over 02?
Yes — 2.3 adds improved body motion, micro-expressions, and dedicated anime/illustration styles not available in the 02 generation.
Met welke variant moet ik beginnen?
Kies de goedkoopste variant die aan je kwaliteitsnorm voldoet. De meeste teams beginnen met de snelle variant en stappen over op pro voor productie.
Is er een gratis tier?
Nieuwe accounts krijgen de eerste calls gratis op elk model. Daarna betaal je per call.
Streamen jullie resultaten?
Waar streaming beschikbaar is, streamt RunAPI end-to-end.
Hoe worden mislukkingen gefactureerd?
Mislukte generations worden niet in rekening gebracht.
Worden outputs gecachet?
Gegenereerde outputs worden opgeslagen en zijn op te vragen via task-ID. Inputs worden niet gecachet.
Mag ik het commercieel gebruiken?
Ja — commercieel gebruik is inbegrepen voor elke variant, tenzij een modellicentie het expliciet beperkt. Dat staat aangegeven op de variantpagina.
Hoe zit het met rate limits?
Rate limits per key schalen mee met je usage tier. Zie de prijzenpagina voor de actuele limieten.
Waar kan ik problemen melden?
Open een issue in de publieke GitHub-repo of mail support.