概要
MiniMax H3 (Hailuo 3.0) は、MiniMax が 2026-07-31 (UTC+8) にリリースしたオムニモーダル動画モデルです。単一のモデルでテキスト、画像、動画、音声を入力として受け取り、ステレオ音声を伴う動画を出力します。APIYI では、オープンウェイトのセルフホスト環境からMiniMax-H3 を提供しており、768P、1 クリップあたり 4〜15 秒、秒単位で課金されます。
主な特徴: 1 つのエンドポイントで、テキストからの動画生成、先頭フレーム／末尾フレーム／先頭・末尾フレーム指定動画生成、ならびに最大 9 枚の画像、3 本の動画、3 件の音声クリップを用いた混合リファレンス生成に対応しています。すべてのクリップに音楽と効果音が付与されます。1 秒あたり $0.03（MiniMax 公式 API では $0.08）のため、10 秒のクリップは $0.30 となり、失敗したタスクは自動的に返金されます。
動画生成 API リファレンス
タスクを作成し、task_id で照会。Python / cURL / Node.js のサンプルコードとライブ Playground を提供
チャージボーナス
チャージボーナスにより、実質価格をさらに引き下げることができます
AIエージェントに統合を任せる
このpromptをコピーして Codex / Claude Code / Cursor に貼り付けてください
エージェントはまずこのページのプレーンテキスト版（任意のドキュメントURLの末尾に .md を追加）を取得し、お使いの技術スタックに合わせたコードを作成します。よくある間違いはすでに明記されています：パスには /hailuo が必要、結果は task 内に格納される、duration は4〜15の整数である必要がある、などです。
このプロジェクトで MiniMax-H3 の動画生成（テキストから動画 / 最初と最後のフレームによる動画 / リファレンス動画）を統合またはデバッグしてください。
コードを書く前にドキュメントを読んでください：このページのプレーンテキスト版として https://docs.apiyi.com/en/api-capabilities/minimax-h3/overview.md を取得してください。パラメータとコードサンプルは https://docs.ap … にあります。
- エンドポイント：
POST https://api.apiyi.com/hailuo/v2/video_generationで送信、… で照会
合計10個の要件があります。以下のボタンを使用して完全なpromptをコピーしてください。
このpromptが防ぐミス
このpromptが防ぐミス
APIYI の MiniMax-H3 が選ばれる理由
完全な機能セット
テキスト、開始・終了フレーム、画像／動画／音声の混合参照生成にすべて対応しており、公式モデルと同じ参照制限（画像9枚＋動画3本＋音声クリップ3本）が適用されます
秒単位の課金、失敗時は返金
1秒あたり$0.03で、生成に成功した動画にのみ課金されます。失敗したタスクは全額返金され、送信エラーは無料です
チャージボーナスの併用が可能
チャージボーナスと組み合わせることで、実質コストをさらに抑えられます
障壁のないグローバルアクセス
1つのAPIキーで
api.apiyi.comに直接接続でき、海外アカウントは不要です充実した動画モデルラインナップ
同じキーでSeedance 2.0 / 2.5、Wan2.7、VEO 3.1などもご利用いただけます
プロフェッショナルサポート
連携に関するご質問はサポートまでお問い合わせください。エンタープライズのお客様にはハンズオンでのオンボーディングを提供しています
主な機能
ネイティブステレオオーディオ
すべてのクリップにpromptや任意の参照オーディオに基づいた音楽と効果音が含まれており、ダビングの工程は不要です
7つのアスペクト比
21:9から9:16までの6つの固定比率に加え、参照画像に追従するadaptiveに対応しています4〜15秒の任意の整数秒
リクエストされた実際の秒数に基づいて課金されるため、短いクリップほど低コストになります
長文のprompt
1つのpromptあたり最大7,000文字まで対応しており、カットごとの詳細な描写にも十分です
先頭・末尾フレームの制御
先頭フレームのみ、末尾フレームのみ、またはその両方を指定して、クリップの開始と終了の様子を設定できます
複数の参照画像
最大9枚の参照画像に対応しています。prompt内で
<Picture 1>などを使用してキャラクターやオブジェクトをタグ付けできます動画からのモーション転送
カメラワークや動きのリズムを再現するために、最大3本の参照動画を指定できます
オーディオ駆動の動画
最大3つの参照オーディオクリップに対応しており、映像が音楽や音声に追従します
料金
本チャンネルは、独自のデプロイ環境でMiniMaxのオープンH3重みを実行しています。公式MiniMax APIのリレーではないため、独自の料金が適用されます：本チャンネルはオープン重みのセルフホストデプロイメントであり、公式MiniMax APIとは個別に料金が設定されており、価格は変更される場合があります。上記の表は参考用であり、トップナビゲーションのモデル料金タブの情報が正式なものとなります：モデル料金。公式価格は
platform.minimax.io/docs/guides/pricing-paygoより（2026-09-29取得）。課金の詳細:
- リクエストされた
duration（秒単位）に基づいて課金され、タスク受付時に事前課金されます - 参照メディアの追加料金なし：参照画像（最大9枚）、動画、音声によって料金が変わることはなく、再生時間のみが課金されます
- 失敗したタスク（メディアのダウンロード失敗、未対応フォーマット、実行失敗など）は、自動的に全額返金されます
- 送信時に4xx / 5xxを返したリクエストは課金されません。照会およびダウンロードは無料です
- 実質コストを抑える方法については、チャージボーナスをご確認ください
グループの設定
MiniMax-H3は**defaultグループで利用可能であり、svipグループでも動作します。専用のグループは不要です。Tokenの課金モデルは従量課金優先**に設定することをお勧めします。呼び出し時に「no available channels for the current group」と返される場合、Tokenのグループにこのモデルが含まれていないか、modelの値のスペルが誤っている（大文字と小文字は区別されます）可能性があります。
技術仕様
推定生成時間
MiniMax-H3 の生成時間は、主に出力時間と参照動画が含まれているかどうかの2点に依存します。以下の表は、2026-09-29 から 2026-10-10 (UTC+8) までの400件以上の成功タスクに基づいた、本チャネルの現状を示しています。- 時間は動画の長さ以上に増加します: 15秒のクリップは、5秒のクリップの3倍ではなく約5倍の時間がかかります
- 参照動画は最も時間がかかります: モデルが参照動画をフレームごとに解析し、新しいフレームと一緒に計算するため、処理負荷が何倍にも増大します
- この表を参考にクライアントのタイムアウトを設定してください: 実行中のタスクを失敗と誤認しないよう、参照動画なしのタスクには30分、参照動画ありのタスクには2時間を設定してください
これらは本チャネルにおける現在の実測値です。時間に制約があるワークロードの場合は、4〜6秒のクリップから始めるか、参照動画の代わりに参照画像を使用してください。より高速で高品質な MiniMax グループがまもなく登場予定です。本ページおよび変更履歴でお知らせいたします。
APIエンドポイント
生成モード
生成モードはcontent[]内のメディアから判定されます：
prompt内でのメディアの参照
各メディアタイプはcontent[]内の順序に従って番号付けされます。1つ目と2つ目の参照画像は<Picture 1>と<Picture 2>、1つ目の参照動画は<Video 1>、1つ目の参照音声クリップは<Audio 1>となります。例えば：
ベストプラクティス
1
まずは4〜5秒でテストする
課金は秒単位で行われるため、10〜15秒のレンダリングを行う前に、短いクリップで構図やスタイルを確認してください
2
テキストからの動画生成には固定のアスペクト比を使用する
横長には
16:9、縦長には9:16、ワイドスクリーンには21:9を使用します。最初のフレームを指定する場合、adaptiveにより画像の比率が維持されます3
メディアは安定したパブリックストレージにホストする
ホットリンク保護や署名の期限切れによってメディアのダウンロードが失敗しないよう、独自のオブジェクトストレージやCDNの直リンクを使用してください
4
カメラワークとサウンドを指定する
被写体、アクション、カメラの動き、照明、そして希望する音楽や効果音をプロンプトに含めてください。モデルがこれらをまとめて生成します
5
10秒ごとにポーリングする
5秒のクリップには通常約3分かかります。全体のクライアントタイムアウトは、参照動画がない場合は30分、参照動画がある場合は2時間に設定してください（「推定生成時間」を参照）
6
冪等性は独自に処理する
ビジネスIDからtask_idへのマッピングを保持してください。送信がタイムアウトした場合は、再送信する前に既存のタスクを確認してください
7
動画はすぐに保存する
GETで
task.content.urlをダウンロードし、独自のストレージから配信してくださいエラーコードとリトライ
クライアント側のヒント: 送信タイムアウトを60秒に設定してください（ピーク時は送信だけで10秒以上かかる場合があります）。リトライはバックオフを設けた上で、HTTP 500およびネットワークエラーのみに限定してください。実行ステージでの失敗はすべて自動的に返金され、再送信すると新たに課金が発生します。
よくある質問
なぜJSONではなくWebページが返されるのですか？
なぜJSONではなくWebページが返されるのですか？
パスに
/hailuo プレフィックスが含まれていません。正しいパスは /hailuo/v2/video_generation および /hailuo/v2/query/video_generation/{task_id} です。2Kや1080Pはサポートされていますか？
2Kや1080Pはサポートされていますか？
このチャンネルでは
768P のみサポートされています。公式のMiniMaxモデルは2Kをサポートしていますが、このチャンネルでは提供されていません。1〜3秒に設定できますか？
1〜3秒に設定できますか？
いいえ。
duration は4から15までの整数です。動画に音声は含まれますか？音声をオフにすることはできますか？
動画に音声は含まれますか？音声をオフにすることはできますか？
すべてのクリップにステレオ音声トラックが含まれており、無効化するパラメータはありません。不要な場合は後処理でトラックを削除してください。
Idempotency-Keyヘッダーで二重課金を防止できますか？
Idempotency-Keyヘッダーで二重課金を防止できますか？
現在のところ防止できません。同じ
Idempotency-Key で再送信しても、別個に課金される新しいタスクが作成されます。送信したタスクはご自身のアプリケーション側で追跡してください。失敗したタスクは課金されますか？
失敗したタスクは課金されますか？
いいえ。タスクが
failed に達すると自動的に全額返金されます。また、送信時に拒絶されたリクエストも課金されません。Base64やローカルファイルを送信できますか？
Base64やローカルファイルを送信できますか？
いいえ。すべてのメディアは公開されているHTTPS URLである必要があります。まずご自身のオブジェクトストレージにアップロードし、そのリンクを渡してください。
adaptiveはどのようなサイズを生成しますか？
adaptiveはどのようなサイズを生成しますか？
入力画像のアスペクト比に従います（例：正方形の画像の場合は768×768、16:9の画像の場合は1344×768）。テキストのみおよび音声のみのリクエストでは
adaptive を使用できません。15秒を超える参照動画はエラーになりますか？
15秒を超える参照動画はエラーになりますか？
15秒を超える単一のクリップは自動的に最初の15秒にトリミングされますが、複数の参照動画の合計が15秒を超える場合、タスクは失敗します（返金されます）。
生成にはどのくらい時間がかかりますか？
生成にはどのくらい時間がかかりますか？
5秒のクリップで約3分、15秒のクリップで約13分かかります。参照動画を含むタスクはさらに時間がかかり、15秒で約85分かかります。全一覧については上記の「推定生成時間」を参照してください。
動画のURLはどのくらいの期間有効ですか？
動画のURLはどのくらいの期間有効ですか？
すぐに期限切れになることは確認されていませんが、長期的な利用可能性は保証されないため、動画は速やかにダウンロードして保存してください。URLの確認にはGETを使用してください。HEADリクエストは403を返します。
送信時に500 Unknown Errorが返されることがある場合はどうすればよいですか？
送信時に500 Unknown Errorが返されることがある場合はどうすればよいですか？
まずリクエストボディがルールに従っていることを確認してください（テキスト項目が正確に1つであること、余分なフィールドがないこと、HTTPSのメディアリンクであること）。ルールに従っている場合は通常、一時的な過負荷が原因です。数秒待ってから再試行してください。送信に失敗した場合は課金されません。