Video · MiniMax

Hailuo API

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

جاهز للتشغيل · 6 variants · ابتداءً من $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 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 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.

عدة إصدارات لمستويات مختلفة من السرعة / الجودة
يتضمن model skill التوثيق والـschemas وملاحظات الإعداد
يعمل مع workflows موجهة لتطوير التطبيقات
لا يتم احتساب رسوم على عمليات التوليد الفاشلة

VARIANTS

قارن جميع إصدارات API

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

SKILLS

ثبّت skill Hailuo لتطوير التطبيقات

حمّل توثيق النموذج والـschemas وملاحظات الأسعار وخطوات الإعداد إلى مساحة عمل الكود.

# 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.

كيف يعمل

من model skill إلى أول نتيجة في أربع خطوات

اختر النموذج

اختر النموذج والإصدار المناسبين لنوع المخرجات ومستوى الجودة وزمن الاستجابة المستهدف.

الإعداد

اضبط مفتاح RunAPI وثبّت model skill في مساحة عمل الكود.

التنفيذ

استخدم تعليمات المهارة لإضافة ميزة النموذج داخل تطبيقك.

الاستلام

استعلم عبر task ID أو استخدم البث عند دعمه أو عالج webhook callback.

CONTEXT

ما هي 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

لماذا RunAPI

لماذا تستخدم Hailuo API عبر RunAPI

مصادقة واحدة لكل مزود

مفتاح RunAPI واحد يفتح الوصول إلى الكتالوج بالكامل. لا حسابات منفصلة، ولا تدوير مفاتيح لكل تكامل.

تسعير وفوترة موحّدان

تسعير لكل استدعاء بالدولار الأمريكي، ويُفوتر شهريًا. لا تُحتسب التوليدات الفاشلة.

Skill مع schemas

تأتي الـschemas المعرّفة وملاحظات الإعداد داخل model skill حتى يبدأ التنفيذ من العقد الصحيح.

FAQ

أسئلة شائعة

What resolution does Hailuo output?

1080p أصلي على متغيرات Pro. تصل متغيرات Standard إلى 768p، مع وصول Hailuo 2.3 standard إلى 1080p. لا حاجة لتحسين الدقة بعد المعالجة لفئة Pro.

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 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.

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.

أي نسخة ينبغي أن أبدأ بها؟

اختر أرخص نسخة تفي بمعيار الجودة لديك. يبدأ معظم الفرق بالنسخة السريعة ثم ينتقلون إلى pro للإنتاج.

هل توجد خطة مجانية؟

تحصل الحسابات الجديدة على أول طلبات مجانية على كل نموذج. بعد ذلك، الدفع حسب كل طلب.

هل تدعمون البث المباشر للنتائج؟

حيث يتوفر البث المباشر، يوفّر RunAPI البث من البداية إلى النهاية.

كيف يتم احتساب الرسوم عند الفشل؟

لا يتم تحصيل رسوم على عمليات التوليد الفاشلة.

هل يتم تخزين المخرجات مؤقتًا؟

يتم حفظ المخرجات المولدة ويمكن استرجاعها بواسطة task ID. لا يتم تخزين المدخلات مؤقتًا.