MiniMax Hailuo 02 の使い方：完全ガイド

MiniMax Hailuo 02 は、映像、動き、エフェクトを精密にコントロールしながら、映画のような品質の動画を作れる強力な AI モデルです。APIMart では MiniMax Hailuo 02 API から利用でき、テキストから動画、画像から動画、最初と最後のフレームを使ったトランジションに対応し、最大 1080p の高品質な短いクリップを生成できます。押さえておきたいポイントは次のとおりです。

• 主な機能：テキストプロンプト、最初のフレーム画像、または最初と最後のフレームのペアから動画を作成でき、カメラの動きはプロンプトの中で直接説明します。
• 料金：2026年10月時点で、APIMart の 1080p クリップは 1 秒あたり $0.08 です。最新の料金はモデルページで確認してください。
• セットアップ：API キーを発行し、パラメータを指定してリクエストを組み立て、非同期のポーリングで動画を取得します。
• 用途：広告、製品紹介、ストーリーボード、研修動画に最適です。

まずは APIMart アカウントを作成して API キーを安全に保管し、以下のステップバイステップガイドに沿って動画を生成しましょう。具体的なプロンプトと明確なカメラ指示を使うと、動画の品質を最大限に引き出せます。長めのプロジェクトでは、一貫したフレームで複数のクリップをつなげるか、別のシネマティックな生成手段として Kling V3 API を検討してください。

重要ポイント

• MiniMax Hailuo 02 は、APIMart 経由でモデル ID MiniMax-Hailuo-02 を使い、テキストから動画、画像から動画、最初から最後のフレームへのトランジションクリップを最大 1080p で生成します。
• ワークフローは、APIMart アカウントを作成し、API Key Management で一度だけ表示されるキーを発行し、JSON ボディを https://api.apimart.ai/v1/videos/generations に POST してから、ステータスが completed になるまで 15〜30 秒ごとに /v1/tasks/{task_id} をポーリングする流れです。
• 主なパラメータは prompt、5 秒または 10 秒の duration、512p・768p・1080p の resolution、公開 URL または Base64 で渡す first_frame_image と last_frame_image、デフォルトで true の prompt_optimizer です。
• 2026年10月時点の APIMart 料金は 512p が 1 秒あたり $0.0104、768p が $0.04、1080p が $0.08 です。完成した動画は data.result.videos[0].url[0] から取得し、結果は 72 時間保持されるので、早めに保存しましょう。
• APIMart では 1080p は 5 秒クリップのみで、ネイティブ音声はありません。10 秒を超える動画は、最後のフレームを次の first_frame_image としてつなげます。

MiniMax Hailuo 02 の概要

APIMart で MiniMax Hailuo 02 を使い始める

アカウント設定と API キーの取得

まずは apimart.ai にアクセスしてアカウントを作成します。チームで使う場合、APIMart では organization（組織） を作成できます。全員が共通の残高を使えるので、個人の認証情報をやり取りする必要がなく、共同作業がスムーズになります。

アカウントの準備ができたら、共有残高にチャージします。この残高は APIMart のすべてのモデルで使え、プロ品質の動画生成に使える Veo 3.1 API のようなハイエンドモデルも含まれます。次に、コンソールダッシュボードの API Key Management セクションで API キーを発行します。

注意点として、API キーは一度しか表示されません。 必ずコピーして、パスワードマネージャーやシークレット管理ツールなどに安全に保管してください。コードで使うときは、直接埋め込まずに環境変数（例：APIMART_API_KEY）から読み込みます。コードを共有したりバージョン管理にアップロードしたりしたときに、うっかり漏れるリスクを減らせます。送信するすべての API リクエストには、このキーを Authorization ヘッダーに含めます。

Authorization: Bearer YOUR_API_KEY

チームの場合、Organizations 機能を使えばアクセスを一元管理でき、個人アカウントの認証情報を共有する必要がありません ^[2]。API キーの準備ができたら、リクエストパラメータを設定して動画の生成を始められます。別の高品質な選択肢として Grok Imagine Video API も試せます。

MiniMax Hailuo 02 リクエストの主要パラメータ

API キーを確保したら、適切なパラメータでリクエストを組み立てます。"model": "MiniMax-Hailuo-02" フィールドは必須で、ほかにもいくつかのパラメータがあります。特に重要なものは次のとおりです。

重要なポイントとして、動画生成は非同期です。 リクエストを送ると、API は動画そのものではなく task_id を返します。ステータスが "completed" に変わるまで、15〜30 秒ごとに /v1/tasks/{task_id} をポーリングする必要があります。完成したら早めにダウンロードしましょう。結果は 72 時間 保持されます ^[1]。

パラメータが整ったら、MiniMax Hailuo 02 を最大限に活かす効果的なプロンプト作りに集中できます。

効果的なプロンプトの書き方

良いプロンプトは高品質な動画を作るための鍵です。よく構成されたプロンプトには、カメラショットまたは動き、被写体とその説明、動作、シーン、照明、スタイルまたはムードの 6 つの要素 が含まれます。たとえば「街を歩く女性」のような曖昧な説明ではなく、「トラッキングショット：赤いコートの女性が、夕暮れ時の雨に濡れたマンハッタンの通りを足早に歩き、濡れた路面にネオンサインが映り込む、シネマティックなノワールスタイル」のように具体的に書きます。

動画に躍動感を出すには、プロンプトの冒頭で「ゆっくりプッシュイン」「トラッキングショット」「固定ショット」のように、カメラの動きを普通の言葉で説明します。APIMart の Hailuo 02 ドキュメントには角括弧付きのカメラコマンド一覧はありません。このガイドの後半で紹介する 15 種類の角括弧付き中国語カメラコマンドは、Hailuo 2.3 のドキュメントに記載されているものです。

複雑なシーンでは prompt_optimizer を true のままにしておきましょう。この機能が説明を自動的に洗練・補完してくれるので、ほとんど手間をかけずに、よりスムーズで一貫性のある動画が得られることがよくあります ^[1]。

Hailuo 02 でシネマティックな AI 動画を作成する方法

ステップバイステップガイド：MiniMax Hailuo 02 で動画を生成する

基本的なテキストから動画への API リクエストの送り方

API キーとプロンプトの準備ができていれば、最初のリクエストを送るのは簡単です。https://api.apimart.ai/v1/videos/generations に POST リクエストを送ります。ヘッダーに Bearer Token を含め、次のような JSON ボディを使います。

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Tracking shot: a lone astronaut walks across a red desert at golden hour, dust swirling around their boots, cinematic wide-angle style.",
  "duration": 5,
  "resolution": "1080p"
}

重要： 1080p 解像度は 5 秒クリップのみ対応しています。10 秒の動画にするには、解像度を 768p または 512p に下げる必要があります。料金は解像度と長さの両方で決まります。2026年10月時点で 768p は 1 秒あたり $0.04、1080p は $0.08 です。最新の料金はモデルページで確認してください。

リクエストを送信すると、API は data[0].task_id に task_id を返し、ステータスは submitted になります。レンダリング時間は解像度、長さ、そのときの負荷によって変わるので、タスクが終わるまでポーリングを続けましょう。

画像から動画機能の使い方

画像から動画のリクエストでは、追加のパラメータ first_frame_image を含める必要があります。これは公開 URL（例：https://example.com/start.jpg）か、Base64 エンコードされた Data URL 文字列のどちらでも構いません。画像が指定のファイル形式、サイズ、アスペクト比の要件を満たしていることを確認してください。

画像がすでにシーンの見た目を伝えているので、プロンプトでは見た目の細部ではなく動きを説明します。たとえば、開始画像がテーブルの上の商品なら、"Slow zoom in. Product rotates gently, soft studio lighting, clean white background" のようなプロンプトで、どう動かすかをモデルに伝えます。出力の解像度は入力画像のサイズに合わせられるため、シャープな結果を得るには高品質な元画像を使うことが欠かせません。

より高度な表現をしたい場合は、first_frame_image と一緒に last_frame_image を指定できます。2 枚の画像の間をつなぐトランジション動画が作られ、製品の公開、ビフォーアフターの比較、大きなプロジェクトでのシーン転換などにぴったりです。

リクエストを設定したら、API のレスポンスを確認してアニメーション化された動画を取得します。音声の統合が必要なプロジェクトでは、同期した音声生成に対応した Veo 3.1 API も検討してください。

API レスポンスの読み方と出力のダウンロード

GET https://api.apimart.ai/v1/tasks/{task_id} をポーリングします。タスクのステータスが completed になると、動画の URL は data.result.videos[0].url[0] に入っています。別のファイル ID やダウンロード用エンドポイントはありません。ステータスの流れは次のとおりです。

ステータスが completed に変わるまで、15〜30 秒ごとに /v1/tasks/{task_id} エンドポイントをポーリングします。完了したら、返された URL から動画をダウンロードします。結果は 72 時間保持されるので、早めに自分のストレージに保存しましょう ^[1]。

Python を使う場合は、requests.get(video_url).content で動画をダウンロードし、.mp4 ファイルとして保存できます。video_url はタスクのレスポンスにある data["result"]["videos"][0]["url"][0] です。

最後に、API レスポンスの code フィールドは必ず確認してください。200 はリクエストが成功したことを意味しますが、レンダリングのエラーがないか、引き続きタスクのステータスを監視する必要があります ^[1]。

動画品質の向上とワークフローへの統合

プロンプトとパラメータ設定を磨く

動画の品質を上げるには、[被写体と動作]、[物理的・環境的な要素]、[カメラの動き]、[照明・雰囲気]、[品質の記述] という形式でプロンプトを組み立ててみてください ^[7]。例：「バリスタがエスプレッソに湯気の立つミルクを注ぎ、液体がスローモーションで渦を巻く、ゆっくりズームイン、温かみのあるカフェの照明、シネマティックな品質」。この形にすると、モデルがリアルな動きや雰囲気をより効果的に再現しやすくなります。

明示的なカメラタグが必要な場合、APIMart の MiniMax Hailuo 2.3 API は 15 種類の角括弧付き中国語カメラコマンド に対応しています。プロンプトの冒頭に、表記どおりのラベルで書き込みます ^[3]。早見表は次のとおりです。

prompt_optimizer 機能はデフォルトで有効になっており、一般的に出力品質を高めてくれます。非常に細かい台本どおりに生成させたい場合を除き、オンのままにしておきましょう。スピードを優先し、多少仕上がりが粗くても構わないなら、fast_pretreatment: true を設定すると前処理の時間を短縮できます ^[1][6]。

プロンプトと設定が固まったら、より大きなパイプラインに組み込んで制作の質を高めましょう。

APIMart でマルチモデルのパイプラインを構築する

Hailuo 02 は、音声や長いシーケンスを補うツールと組み合わせると最も力を発揮します。水、火、布といった動きのある B ロール映像を作るのは得意ですが、音声は生成しません。このギャップを埋めるには、ポストプロダクションで MiniMax Audio のツール、たとえばナレーションには Speech 2.8、サウンドトラックには Music 2.6 を組み合わせます ^[8]。ブランドや商用のプロジェクトでは、まず画像モデルでベースとなるフレームを作り、それを first_frame_image として Hailuo 02 に渡すと、構図を精密にコントロールできます ^[7]。

10 秒を超える動画では、完成したクリップの最後のフレームをキャプチャし、次のリクエストの first_frame_image として使います。こうすると、複数のクリップにわたってキャラクターの細部や環境の照明を一貫させやすくなります ^[8]。

エラー処理と API のベストプラクティス

プロンプトやパイプラインを磨いても、問題は起こりえます。次のベストプラクティスに従って、トラブルシューティングと API レスポンスの最適化を効果的に進めましょう。

Hailuo 02 で最も多い失敗は、サポートされていない解像度と長さの組み合わせ と 無効な画像入力 の 2 つです。解像度と長さの設定が互換性のある組み合わせかを必ず確認してください ^[1][6]。画像から動画のタスクでは、MiniMax 自身のドキュメントが、元画像を 20MB 未満、短辺 300px 超、アスペクト比 2:5〜5:2、形式は JPG・PNG・WebP にすることを推奨しています ^[5]。

タスクが失敗したら、必ずタスクのレスポンスにある error フィールドを確認してください。問題をすばやく解決するための詳細が記載されています。本番環境では、ポーリング間隔をほどほどに保ち、指数バックオフでリトライしましょう。不要な API 呼び出しを減らし、ワークフローの応答性を保てます。

まとめ：重要ポイント

動画生成ツールとして MiniMax Hailuo 02 が際立つ理由を手短に振り返ります。

MiniMax Hailuo 02 は、驚くほどの精度で映画品質の動画制作を実現します。NCR アーキテクチャにより、以前のモデルと比べてパラメータは 3 倍、学習データは 4 倍となっており ^[7]、水、火、煙、布といった複雑な要素を非常にリアルに表現できます。

2026年10月時点で、APIMart では 768p が 1 秒あたり $0.04、1080p が $0.08 で ^[2]、プロの制作からクリエイティブな実験まで実用的な選択肢になります。

このモデルの主な特長は次のとおりです。

• 精密なコントロールが可能な画像から動画ツール
• プロらしい映像表現のための、プロンプト内でのカメラ指示（例：「トラッキングショット」「ゆっくりズームイン」）
• 長いシーケンスでもスムーズにつながる最後のフレームによる連続性

なお、APIMart では 1080p クリップは 5 秒までです（MiniMax の発表では 6 秒とされています）。長い動画には 768p が良い選択肢で、より低い料金で 10 秒のクリップを作れます ^[1]。

これらの機能により、MiniMax Hailuo 02 は動画制作のワークフローを次のレベルへ引き上げてくれます。

よくある質問

10 秒より長いクリップを作るには？

MiniMax Hailuo 02 のクリップは最長 10 秒で、10 秒のクリップには 768p または 512p が必要です（1080p は 5 秒のみ）。長い動画が必要な場合は、10 秒のクリップを複数生成し、前のクリップの最後のフレームを次の first_frame_image にしてつなげます。

10 秒のテキストから動画クリップでは、リクエストに次のパラメータを含めます。

• duration: 10
• resolution: "768p"
• model: "MiniMax-Hailuo-02"

リクエストを送信したら、ステータスが completed になるまでタスクをポーリングし、data.result.videos[0].url[0] から動画をダウンロードします。

タスクが失敗したらどうすればいいですか？

動画生成タスクが成功しなかった場合は、まず HTTP ステータスとレスポンスの error オブジェクトを確認して原因を特定します。よくあるものは次のとおりです。

• 400：パラメータが無効。サポートされていない解像度と長さの組み合わせなど。
• 401：API キーの認証に問題がある。
• 402：アカウントの残高不足。
• 429：レート制限に達した。

レート制限エラー（HTTP 429）やサーバー関連の問題（HTTP 5xx）には、_指数バックオフ_を実装してみてください。リトライのたびに待ち時間を少しずつ長くする方法です。また、入力パラメータを再確認し、検証エラーを避けるためにプロンプトにセンシティブな内容が含まれないようにしましょう。

クリップ間でキャラクターの一貫性を保つには？

MiniMax Hailuo 02 でキャラクターの一貫性を保つには、各クリップを鮮明で照明の良いキャラクターの first_frame_image から始め、前のクリップの最後のフレームを次のクリップの最初のフレームとして再利用します。複数のクリップを扱う場合は、プロンプトに同じ照明の詳細を含めましょう。視覚的なつながりをより滑らかにするには、ショット間でカメラアングルをそろえ、ポストプロダクションでクロスフェードやマッチカットのような控えめなトランジションも検討してください。こうしたテクニックで、まとまりのある洗練されたストーリーに仕上がります。