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.
- Wiele wariantów dla różnych poziomów szybkości i jakości
- Model skill zawiera dokumentację, schematy i notatki setupu
- Działa z workflow kodowania aplikacji
- Nie płacisz za nieudane generacje
Porównaj wszystkie warianty API
| Variant | Billing | From | |
|---|---|---|---|
| hailuo-02-image-to-video-pro | call | $0.570 | Zobacz → |
| hailuo-02-image-to-video-standard | call | $0.300 | Zobacz → |
| hailuo-02-text-to-video-pro | call | $0.570 | Zobacz → |
| hailuo-02-text-to-video-standard | call | $0.500 | Zobacz → |
| hailuo-2.3-image-to-video-pro | call | $0.900 | Zobacz → |
| hailuo-2.3-image-to-video-standard | call | $0.500 | Zobacz → |
Zainstaluj skill Hailuo do tworzenia aplikacji
Wczytaj dokumentację modelu, schematy, notatki cenowe i kroki setupu do workspace kodu.
# 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.
Od model skilla do pierwszego wyniku w czterech krokach
Wybierz model
Wybierz model i wariant pasujące do typu wyjścia, progu jakości i celu opóźnienia.
Konfiguracja
Ustaw klucz RunAPI i zainstaluj model skill w workspace kodu.
Implementacja
Użyj instrukcji skilla, aby dodać funkcję modelu w swojej aplikacji.
Odbiór
Odpytuj po task ID, streamuj gdy wspierane albo obsłuż callback webhook.
Czym jest API Hailuo?
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.
Dlaczego używać API Hailuo przez RunAPI
Jedno uwierzytelnienie, wszyscy providerzy
Jeden klucz RunAPI odblokowuje cały katalog. Bez osobnych kont i rotacji kluczy dla każdej integracji.
Ujednolicony cennik i rozliczenia
Rozliczanie za wywołanie w USD, fakturowane co miesiąc. Nieudane generacje nie są naliczane.
Skill ze schematami
Typowane schematy i notatki setupu są spakowane w model skill, więc implementacja startuje od właściwego kontraktu.
Najczęstsze pytania
What resolution does Hailuo output?
Natywne 1080p w wariantach pro. Warianty standard generują do 768p, a Hailuo 2.3 standard osiąga 1080p. Warstwa pro nie wymaga upscalingu w post-processie.
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 generuje w natywnym 1080p z lepszą szczegółowością i wiernością ruchu. Standard generuje do 768p (Hailuo 2.3 standard osiąga 1080p) i kosztuje około 50% mniej.
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.
Od jakiego wariantu powinienem zacząć?
Wybierz najtańszy wariant, który spełnia Twoje wymagania jakościowe. Większość zespołów zaczyna od szybkiego wariantu, a do produkcji przechodzi na pro.
Czy jest darmowy plan?
Nowe konta otrzymują darmowe pierwsze wywołania dla każdego modelu. Później płacisz za każde wywołanie.
Czy streamujecie wyniki?
Tam, gdzie streaming jest dostępny, RunAPI streamuje end-to-end.
Jak są rozliczane nieudane próby?
Nieudane generacje nie są obciążane opłatą.
Czy wyniki są buforowane?
Wygenerowane wyniki są zapisywane i można je pobrać po ID zadania. Dane wejściowe nie są buforowane.
Czy mogę używać komercyjnie?
Tak — użycie komercyjne jest dostępne dla każdego wariantu, chyba że licencja modelu wyraźnie to ogranicza; informacja taka jest podana na stronie wariantu.
A co z limitami zapytań?
Limity na klucz rosną wraz z poziomem wykorzystania. Aktualne limity znajdziesz na stronie cennika.
Gdzie mogę zgłosić problem?
Otwórz zgłoszenie w publicznym repozytorium GitHub albo napisz do supportu.