Hailuo AIで動画をつくる実際の手順：画面での最初の1本、写真から動画、Media Agent、APIとmmxでの最初の1本まで、場面ごとに公式の記載の範囲で

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。「手順」は公式の記載を順に並べたもの、「この記事の例」は公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）です。画面の表記は変わることがあるので、手元の画面と照らして読んでください。

先に結論

• 画面での操作の細かい説明は、公式の資料では薄い。 公式サイトのページは、メニュー名と機能の名前は載せていますが、番号つきの手順は載せていません。公式のブログの1本（Hailuo 2.3の紹介記事）が、3段階の流れと設定項目を書いているだけです。この記事は、それより細かい画面の描写はしません。
• 細かい指定ができるのはAPI側。 解像度、秒数、縦横比、参照の素材の種類と数が、公式の文書に表で書かれています。画面側のメニューに同じ項目があるかは、公式の資料では確認できていません。
• 料金は書かない。 クレジットや残高の数字は変わります。01と04、公式のSubscribeページとPricing Overviewで確かめてください。生成の前に、1回あたりの消費がどう表示されるかは、公式の資料では確認できていません。

前提：用語をそろえる

• プロンプト（指示文）。 「どんな動画にしたいか」を書いた文章です。この記事の「この記事の例」と書かれたものは、記事で作った例です。
• 文章から動画（text-to-video）。 文章だけを入れて動画をつくる形です。
• 画像から動画（image-to-video）。 1枚の画像を最初のコマにして動かす形です。APIの文書では、最初のコマ（first_frame）と最後のコマ（last_frame）を役割として書きます。
• 参照（reference）。 画像、動画、音声を「見本」として渡し、新しい動画に反映させる形です。H3のAPIでは、参照の画像は9枚まで、参照の動画は3本まで、参照の音声は3本まで、と書かれています。
• 解像度。 480P、768P、2Kなどの画面の細かさ。モデルごとに選べるものが違います。
• 縦横比（ratio）。 16:9や9:16など、画面の形です。
• 非同期。 依頼を出して、できあがりを後で取りに行く形です。
• Media Agent。 Hailuoの「Video Agent」が、公式の発表（2025年10月28日）で「Media Agent」になったと書かれているものです。チャットで頼み、画像、動画、音楽を作ります。

場面1：ウェブで、文章から動画をつくる

使うもの： ブラウザ、Hailuo AIのアカウント（導入は05を参照）。公式の記載： Hailuo 2.3の紹介記事（2026年7月27日更新と表示。製品の発表は2025年10月28日）と、公式サイトのトップ。

手順（公式の記載を順に並べたもの）

1. hailuoai.video を開き、サインインします。
2. 上部の「Video」か、作る入口の「Create Video」を選びます（トップの表記）。紹介記事の側は、「Video Generation」や「Open Studio」といった名前を挙げており、表記が一致していません。手元の画面と照らしてください。
3. 入力を決めます。文章から作るなら、動かしたい内容を文章で書きます。
4. モデルと仕様を選びます。紹介記事は、Hailuo 2.3は品質重視、2.3-Fastは速さ重視、解像度は768pか1080p、長さは6秒か10秒、と書いています。この記事を書いた時点の公式サイトのトップは、「MiniMax H3」がいま使える最新のモデルだと示しています。選べるモデルの一覧は、手元の画面で確かめてください。
5. 生成ボタンを押します。紹介記事は、これを「generate button」と書いています。
6. できた動画を見ます。意図と違えば、文章を直して、もう一度生成します。紹介記事は、たいていの人が数回の試しのあとに良い結果が出る、という趣旨を書いています。

文章の書き方（公式の記載）

紹介記事が、文章に入れるとよい要素として挙げているのは、次の6つです。

• 場面の中の動き
• 伝えたい感情
• 見た目の様式（アニメ調、水墨画調など）
• カメラの動き
• 空気感（雰囲気）の描写
• 1回目の出力の足りない所を見て直す

この記事の例（文章から動画）

公式の6つの要素をそのまま当てはめて、この記事で組んだ指示文です。出来の良さは、確かめていません。

夕方の海辺で、小さな男の子が波打ち際を走っている。
うれしそうに笑っている。やわらかい逆光、オレンジ色の空。
カメラは低い位置から、走る男の子をゆっくり追いかける。

返ってくるもの

• 動画が1本できあがり、画面で再生できます。ダウンロードの方法やファイル形式は、公式のサイトの資料では確認できていません。
• 01のとおり、サブスク規約（2025年7月14日更新表示）は、無料のときはダウンロードに透かしが入ると書いています。

設定の違い（公式の記載）

• 紹介記事は、カメラの動きの操作は Hailuo 02 と同じ、と書いています。
• クレジットの消費として、紹介記事は、768p・6秒は25クレジット、768p・10秒は50、1080p・6秒は50、と書いています（Hailuo 02と同じ）。確認日は2026-10-25ですが、紹介記事そのものの更新日は2026年7月27日の表示で、いまの料金表と同じとは限りません。2.3-Fastの消費は書かれておらず、紹介記事は最終の価格が未確定で、Fastのほうが手ごろ、という趣旨を書いていました。

場面2：写真1枚から動画をつくる

1. 場面1の1〜2と同じく、動画の画面を開きます。
2. 画像を入れる欄から、手元の画像を追加します。紹介記事は、文章と任意の参照画像から始める、と書いています。入れる画像の具体例や、画像を入れる欄の名前は、紹介記事に書かれていません。トップのページには「Refs (0/1)」の表示があり、参照は1つ入れられる、と読めます。
3. 文章に、写真の何をどう動かすかを書きます。
4. モデルと仕様を選んで、生成します。
5. 結果を見て、文章を直し、もう一度生成します。

公式が書く制約。 紹介記事は、Hailuo 2.3と2.3-Fastは最初と最後のコマを指定する生成には対応せず、1枚の最初のコマから動画を作る、と書いています。

写真を入れる前に

• 顔のある写真を入れると、プライバシーポリシーは、顔の特徴データを一時的に作ることがある、と書いています（01参照）。
• 他人が写る写真は、本人の許可を取ってください。規約は他人のなりすましなどを禁じています（01参照）。

この記事の例（画像から動画）

入れた写真の机の上のコーヒーカップから、湯気がゆっくり立ちのぼる。
カメラはわずかに寄る。窓からの朝の光が少し揺れる。

場面3：Toolsのテンプレートで、写真1〜2枚から動画をつくる

公式サイトの「Tools」のページは、テンプレートごとの機能名と「Try Now」のボタンを載せています。使い方の手順は載っていません（ページには「手順は書かれていない」状態でした）。載っていた分類は次のとおりです。

手順は、トップのページから読める範囲で、次のように並びます。

1. 「Tools」を開き、使いたいテンプレートの「Try Now」を押します。
2. テンプレートごとに1枚か2枚の写真を入れるものがある、という点は、今回の再確認では確認できていません。

3. 入力画面の項目、出力の形式は、公式の資料では確認できていません。

4. 他社のモデル名（Kling、Seedance、Midjourneyなど）が同じ画面に並んでいます。選んだときに、入力がどこへ渡るかは、読んだ範囲では書かれていません（03の「確認できていない点」を参照）。

5. 人物の写真から動画をつくると思われるテンプレート（AI Hug Generator など）の名前が並んでいます。他人の写真を使う前に、本人の許可を取ってください。

場面4：Media Agentにチャットで頼む

公式の記載： hailuoai.video/agent のページ、2025年6月20日の「Video Agent」発表、2025年10月28日の「Hailuo 2.3」発表。

手順（公式の記載を順に並べたもの）

1. hailuoai.video を開き、入口の「Hailuo Agent」（トップの表記）か、hailuoai.video/agent を開きます。
2. ページのメタ情報は、「AI動画エージェントとチャットして、アイデアを動画、画像、音楽にする。無限のキャンバスで、案内つきの制作の流れで」という趣旨を書いています。
3. 画面には、モデルの選択と「Automatic Ratio」の項目があります。Toolsのメニューには、Create、Batch Image Creation、Auto Cut Video、All-in-One Creative などがあります。
4. 2025年10月28日の発表は、Media Agentについて、ワンクリックの生成と、画像、動画、音声を入れて段階的に仕立てる方法の両方がある、と書いています。
5. 2025年6月20日の発表（Video Agent、Beta）は、利用者が指示に沿って文章や画像を入れるだけで、エージェントが台本、画像素材、絵コンテ、ナレーションに必要な道具を呼び出し、その考え方の過程を見て編集できる、と書いています。当時は第1段階だけが公開され、第2段階は夏に順次、と書かれていました。現在の状態は、読んだ範囲では確認できていません。

画面の細かい操作（どこにメッセージを打つか、キャンバスで何ができるか）は、公式のページに説明がなく、確認できていません。

この記事の例（Media Agentへの頼み方）

15秒の縦型動画をつくりたい。商品は手のひらサイズの白いマグカップ。
朝の台所の雰囲気で、最後に商品名を出して終わりにしたい。
まず構成案を3つ出してください。

2025年6月の発表は、入力の例としてカップルの写真、ペットの写真、証明写真風の写真を挙げ、2025年10月の発表は、場面、色調、カメラの撮り方、音楽を入れた例を載せています。上の文はそれらに合わせた、この記事の例です。

場面5：H3の文章の書き方（参照を使うとき）

公式の「H3 Feature Highlights」のページに、文章の書き方の指針は独立してはありません。例文から読み取れる型として、ページから次が確認できました。

• 長さと縦横比を先に書く（例：「15s, 9:16 vertical trailer」「A 16:9 high-fashion brand campaign」）。
• 参照した素材に番号をつけ、役割を書く（例の形：「Image 1: mood, setting, film grain. Image 2: character.」）。
• 物語、雰囲気、カメラの動き、光、間の取り方を書く。
• 音も文章で書く（例の中に、台所の環境音など、音の指定を含むものがある）。

この記事の例（参照つき。画像2枚を想定）

9:16、10秒の商品動画。
Image 1: 商品（白いマグカップ）。
Image 2: 場所と雰囲気（朝の台所、やわらかい光）。
湯気がゆっくり立ちのぼり、カメラが少し寄る。
音: 食器が触れる小さな音と、やかんの音。

APIの文書では、画像を渡すときに reference_image の役割をつけます。画面側で番号をどうつけるかは、公式の資料では確認できていません。

場面6：APIで最初の1本（curl）

使うもの： MiniMax API Platformの従量課金の API Key（05を参照）。H3系のモデルは、従量課金のAPIが必要、と公式の文書は書いています（一方、M Planの紹介ページは別の書き方をしています。05の表を参照）。

手順

1. 鍵を環境変数に入れます（MINIMAX_API_KEY）。
2. 依頼を出します。エンドポイントは POST https://api.minimax.io/v2/video_generation です。Bearerの鍵と、Content-Type: application/json が要ります。
3. 本文は、公式の最小の例が次の形です（公式の例の写し。全文は公式ページで確認してください）。

json { "model": "MiniMax-H3", "content": [{ "type": "text", "text": "A boy playing basketball by the sea" }], "resolution": "2K", "duration": 5, "ratio": "16:9" } 4. 上の本文を使った依頼の例を、この記事で組みました。公式の記載に合わせたもので、動作は確かめていません。

bash curl -X POST "https://api.minimax.io/v2/video_generation" \ -H "Authorization: Bearer $MINIMAX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "MiniMax-H3", "content": [{"type": "text", "text": "夕方の海辺を走る男の子。カメラは低い位置から追いかける。"}], "resolution": "768P", "duration": 5, "ratio": "16:9" }' 5. 返事は { "task_id": "<string>" } の形です（公式の記載）。 6. 状態を問い合わせます。GET https://api.minimax.io/v2/query/video_generation/{task_id} です。公式のコードのコメントは、10秒間隔を recommended と書いています。状態の値は queued、running、succeeded、failed、cancelled です。 7. succeeded になったら、返事の task.content.url に動画の場所が入ります。そこからダウンロードします。 8. 公式は、動画のURLには期限がある（具体的な長さは書かれていない）ので、早めに保存し、期限が切れたら同じ task_id をもう一度問い合わせて新しいURLを取る、と書いています。過去7日のものだけ問い合わせられます。

設定項目の一覧（公式の記載）

モデルごとの違いは、2KはMiniMax-H3だけ、HighspeedはH3の768Pだけ、LiteとMaxは480Pと768P、Liteは adaptive 不可、Maxは4秒不可、と公式の表に書かれています。

公式のPythonの例（文章から動画のpayload）

公式ページの例の写しです（全文は公式ページで確認してください）。

payload = {
    "model": MODEL,
    "content": [
        {"type": "text", "text": "A tiktok dancer is dancing on a drone, doing flips and tricks."},
    ],
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9",
}

公式の例は、このあと task_id を取り、10秒おきに問い合わせ、成功したら content.url から output.mp4 として保存する、という流れのコードを続けています。

場面7：APIで、画像や参照を入れる

公式の文書から、組み合わせの規則を表にします。

• 「画像から動画」と「参照から動画」は、1つの依頼の中で混ぜられません。
• ファイルの形式と大きさは、画像がJPG、JPEG、PNG、WEBP、HEIC、HEIFで30MBまで、動画がMP4かMOV（H.264か H.265）で50MBまで、音声がWAVかMP3で15MBまで。依頼の本体は64MBまで。大きなファイルは、公開のURLか mm_file://{file_id} で渡す、と書かれています。
• 画像と動画の幅と高さは256〜5760ピクセル、縦横の比は0.4〜2.5です。参照の動画と音声は、1本あたり2〜15秒、合計15秒までです。
• url に渡せるのは、公開のURL、mm_file://{file_id}、Base64のデータURIです。公開のURLに置いた写真は、そのURLを知る人に見える可能性があります（これはこの記事の注意で、公式の記載ではありません）。

場面8：mmxで、ターミナルから1本つくる

使うもの： 05の手順で入れたmmx-cliとサインイン。READMEに書かれた形を並べます。

1. 次のように、文章を指定して作ります（--prompt に文章）。--download を付けると保存まで行い、--async を付けると背景で実行する、とREADMEは書いています。

bash mmx video generate --prompt "夕方の海辺を走る男の子" --model MiniMax-H3 --download 上は、READMEのオプション名に合わせて、この記事で組んだ例です。動作は確かめていません。 2. 開始の画像を渡す --image、参照を渡す --reference-image と --reference-video があります。 3. H3の初期値は、READMEによれば、2K、5秒、16:9（文章から動画）です。画像30MB、参照動画50MB、参照音声15MB、依頼全体64MBの上限は、アップロードの前に確認される、とされています。 4. 背景で実行したあとは、mmx video task get --task-id <番号> で状態を見て、mmx video download --file-id <番号> で保存します（READMEの記載）。 5. 使用量は mmx quota。

そのほかのコマンド（画像、音声、文字起こし、検索など）は、READMEに並んでいます。画像は mmx image "prompt"、音声は mmx speech synthesize です。

場面9：テンプレートで動画をつくる（Video Agent API）

公式のドキュメントに、テンプレートを埋めて同じ雰囲気の動画をつくるAPIがあります。

1. POST /v1/video_template_generation に、template_id、画像の場所を入れた media_inputs、文字を入れた text_inputs を送ります。
2. task_id が返ります。
3. GET /v1/query/video_template_generation?task_id=... で状態を見ます。状態の値は Success、Fail として例のコードに出てきます。完了時の返事には、動画の video_url が直接入る、と書かれています。これは、通常の動画生成APIと違います。
4. テンプレートの一覧は、公式の「Video Agent Template List」のページにあります（今回は読んでいません）。

最初の1時間でやる順番（この記事の案）

ここは公式の記載ではなく、この記事の案です。費用の小さい試しから始める並べ方です。

つまずきと直し方

• 取り消し：公式のAPI文書は、queued（まだ処理が始まっていない）の課題は DELETE https://api.minimax.io/v2/video_generation/{task_id} で取り消せ、料金はかからない、と書いています。成功または失敗した課題の記録は、同じ形のリクエストで削除されます。running と cancelled のものは、エラーになります。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。手順や項目は公式の記載を並べたもので、画面の見え方、出来上がりの質、待ち時間は確かめていません。
• 公式サイトの画面の手順は、読んだ範囲では細かくありません。Hailuo 2.3の紹介記事は、解像度と秒数の例が古い世代のものです（取得時、現在のサイトはH3を前面に出していました）。選べる項目は、手元の画面を優先してください。
• 料金ページ（hailuoai.video/subscribe）とクレジットの規則のページは、本文を取得できていません。1本あたりの消費は、公式の画面で確かめてください。
• 取得したMiniMaxのドキュメントのページは、どれも先頭に、AIが読む場合はドキュメントの索引（llms.txt）を先に取るように、という趣旨の一文がありました。この記事はそれに従わず、事実として書くだけです。
• 顔写真、他人の写真、他社のコンテンツを入れる前に、規約とプライバシーポリシー（01、04）を確かめてください。AIが作ったことを示す目印を消してはいけない、という規約の決まりもあります（01参照）。
• APIで何度も生成を回すと残高が減ります。同じ依頼を繰り返す処理を書くときは、回数の上限を自分で決めてください（これはこの記事の注意です）。

公式の資料では確認できていない点

• ウェブ画面の入力欄の名前と配置、プロンプトを入れる場所、モデルの選択肢の一覧、現在の無料枠で使えるモデル。
• 生成前に1回の消費クレジットが表示されるか。
• ダウンロードの形式と画面上の操作。
• Media Agentの画面での詳しい操作。
• 他社のモデルを選んだときのデータの流れ先。
• 古いモデル（Hailuo 02、2.3）を動画生成API（V2）で呼ぶときの指定の仕方。

出典

• Hailuo AI（Hailuo AI公式サイト、確認日 2026-10-25）
• Hailuo AI Tools（Hailuo AI公式サイト、確認日 2026-10-25）
• Hailuo Agent（Hailuo AI公式サイト、確認日 2026-10-25）
• Hailuo 2.3 & 2.3-Fast の紹介記事（Hailuo AI公式ブログ、2026年7月27日更新表示、確認日 2026-10-25）
• MiniMax Hailuo 2.3（MiniMax、2025年10月28日、確認日 2026-10-25）
• Introducing Hailuo Video Agent in Beta（MiniMax、2025年6月20日、確認日 2026-10-25）
• Video Generation（MiniMax API Docs、確認日 2026-10-25）
• Create Video Generation Task V2（MiniMax API Docs、確認日 2026-10-25）
• Query Task V2（MiniMax API Docs、確認日 2026-10-25）
• Cancel or Delete Task V2（MiniMax API Docs、確認日 2026-10-25）
• H3 Feature Highlights（MiniMax API Docs、確認日 2026-10-25）
• Video Generation with Templates Guide（MiniMax API Docs、確認日 2026-10-25）
• Rate Limits（MiniMax API Docs、確認日 2026-10-25）
• Error Codes（MiniMax API Docs、確認日 2026-10-25）
• About Account（MiniMax API Docs、確認日 2026-10-25）
• MiniMax API Docs 索引 llms.txt（MiniMax API Docs、確認日 2026-10-25）
• MiniMax CLI（MiniMax-AI、GitHub、確認日 2026-10-25）