Hailuo API
ネイティブ1080pでの正確な物理シミュレーションとモーションを持つテキスト・画像→動画向けにHailuo APIにアクセスできます。
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": "ガラスのビー玉が木製の机の上を転がり、端から落ちる6秒間のクリップを生成してください。"
}'
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: "ガラスのビー玉が木製の机の上を転がり、端から落ちる6秒間のクリップを生成してください。",
});
<?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' => 'ガラスのビー玉が木製の机の上を転がり、端から落ちる6秒間のクリップを生成してください。',
]);
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: "ガラスのビー玉が木製の机の上を転がり、端から落ちる6秒間のクリップを生成してください。"
)
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
HailuoはMiniMaxの動画生成モデルで、リアルな物理シミュレーションによるネイティブ1080pの映像を生成できます。standardとproの品質ティアでテキスト→動画と画像→動画生成をサポートしています。
- 品質とレイテンシ目標に合わせたモデルバリアント
- 統合 API key
- Model skill に docs、schema、セットアップメモを同梱
- 失敗した生成は課金されません
バリアント
| Variant | Billing | Pricing | |
|---|---|---|---|
| hailuo-02-image-to-video-pro | call | $0.570 | 見る → |
| hailuo-02-image-to-video-standard | call | $0.500 | 見る → |
| 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 | 見る → |
アプリ開発用に Hailuo skill をインストール
モデル docs、schema、料金メモ、セットアップ手順をコード作業環境に読み込みます。
# Install the model skill for app development workflows
npx skills add runapi-ai/hailuo -g
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.
この model skill で構築する方法
モデルを選ぶ
出力タイプ、品質基準、レイテンシ目標に合うモデルとバリアントを選びます。
一度だけ認証
対応するすべてのモデルに RunAPI key を使います。
skill をインストール
機能実装の前に model skill をコード作業環境へ追加します。
出力を受け取る
task ID でポーリングするか、生成完了時の callback を処理します。
Hailuo の位置づけ
HailuoはMiniMaxの動画モデルで、ネイティブ1080pでの正確な物理とモーションの忠実度で知られています。RunAPI経由では、standardとproバリアントが1つのキーを共有します。
RunAPI 経由で Hailuo を使う理由
1つの API key
モデルやプロバイダーをまたいで同じ認証情報を使えます。
Skill-ready
model skill に schema、セットアップメモ、料金コンテキスト、モデル ID が含まれます。
予測しやすい請求
呼び出し前に従量料金を確認できます。
よくある質問
Hailuoの出力解像度はどれくらいですか?
proバリアントはネイティブ1080pです。standardバリアントは最大768pで出力しますが、Hailuo 2.3 standardは1080pに対応しています。proティアでは後処理のアップスケーリングは不要です。
生成されるクリップの長さはどれくらいですか?
テキスト→動画と画像→動画エンドポイントの両方で1回の生成で最大10秒です。
物理シミュレーションはどれくらいリアルですか?
Hailuoは正確な物理のために専門的にトレーニングされています — 流体力学、物体の衝突、重力、布の動きが高い忠実度でレンダリングされます。
standardとproの違いは何ですか?
Proはネイティブ1080pでより良い詳細とモーションの忠実度で出力します。Standardは最大768pで出力し(Hailuo 2.3 standardは1080pに対応)、コストは約50%低くなります。
Hailuo 2.3は02から改善されていますか?
はい — 2.3は改善されたボディモーション、マイクロ表情、02世代では利用できなかった専用のアニメ/イラストスタイルが追加されています。
このモデルはどう呼び出しますか?
model skill をインストールし、RunAPI key とセットアップメモに従ってください。
失敗した生成は課金されますか?
失敗した生成は課金されません
アプリケーションから呼び出せますか?
はい。コード作業環境に model skill をインストールし、モデル機能を追加するときに利用してください。