Skip to main content

​
概要

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エージェントに統合を任せる

Codex / Claude Code / Cursor を使用して構築する場合は、以下の prompt をそこにコピーしてください。エージェントはまずこのページのプレーンテキスト版を取得し（任意のドキュメント URL に .md を追加）、お使いのスタックに合わせたコードを作成します。よくある誤りはすでに対策されています：パスには /hailuo が必要であること、結果は task の中に存在すること、そして duration は4〜15の整数でなければならないことなどです。

コーディングエージェントにMiniMax-H3の動画生成を統合またはデバッグさせます。Codex、Claude Code、Cursorなどのツールにコピー＆ペーストしてください。

​
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モデルは2Kをサポートしていますが、このチャネルでは768Pのみ提供しており、2K は拒否されます。

​
API エンドポイント

プライマリホストはhttps://api.apiyi.com、バックアップホストはhttps://vip.apiyi.comで、パスは共通です。パスは**/hailuoで始まり**、/v1ではない点にご注意ください。

​
生成モード

生成モードはcontent[]内のメディアから判定されます：

​
prompt内でのメディアの参照

各メディアタイプはcontent[]内の順序に従って番号付けされます。1つ目と2つ目の参照画像は<Picture 1>と<Picture 2>、1つ目の参照動画は<Video 1>、1つ目の参照音声クリップは<Audio 1>となります。例えば：
  • 先頭/最終フレームは、いかなる参照メディアとも組み合わせることはできません
  • 画像が1枚だけの場合はroleを省略できます（先頭フレームとして扱われます）。画像が2枚以上の場合は、それぞれにroleを設定してください
  • 参照動画の合計時間は15秒を超えることはできません。超えた場合、タスクは失敗します（返金処理が行われます）。15秒を超える単一のクリップは最初の15秒間にトリミングされます

​
ベストプラクティス

1

まずは4〜5秒でテストする

課金は秒単位で行われるため、10〜15秒のレンダリングを行う前に、短いクリップで構図やスタイルを確認してください
2

テキストからの動画生成には固定比率を使用する

横向きには16:9、縦向きには9:16、ワイドスクリーンには21:9を使用します。先頭フレームがある場合、adaptiveによって画像の比率が維持されます
3

安定したパブリックストレージにメディアをホストする

直リンク防止や期限切れの署名によってメディアのダウンロードが失敗しないよう、独自のオブジェクトストレージやCDNからの直リンクを使用してください
4

カメラの動きとサウンドを記述する

被写体、アクション、カメラの動き、ライティング、希望する音楽や効果音を含めてください。モデルはこれらをまとめて生成します
5

10秒ごとにポーリングする

生成には通常2〜4分かかります。クライアント全体のタイムアウトは15分に設定してください
6

冪等性は自身で処理する

ビジネスIDからtask_idへのマッピングを保持し、送信がタイムアウトした場合は、再送信する前に既存のタスクを確認してください
7

動画をすぐに保存する

GETでtask.content.urlをダウンロードし、独自のストレージから配信してください

​
エラーコードとリトライ

クライアント側のヒント: 送信タイムアウトを60秒に設定してください（ピーク時は送信だけで10秒以上かかる場合があります）。リトライはバックオフを設けた上で、HTTP 500およびネットワークエラーのみに限定してください。実行ステージでの失敗はすべて自動的に返金され、再送信すると新たに課金が発生します。

​
よくある質問

パスにプレフィックス/hailuoが含まれていません。正しいパスは/hailuo/v2/video_generationおよび/hailuo/v2/query/video_generation/{task_id}です。
このチャンネルでは768Pのみサポートしています。公式のMiniMaxモデルは2Kをサポートしていますが、このチャンネルでは提供していません。
いいえ。durationは4から15までの整数です。
すべてのクリップにはステレオオーディオトラックが含まれており、これを無効化するパラメータはありません。不要な場合は、後処理でトラックを削除してください。
現在は防止できません。同じIdempotency-Keyで再送信した場合でも、個別に課金される新しいタスクが作成されます。送信済みのタスクはご自身のアプリケーション側で追跡してください。
いいえ。タスクがfailedになると自動的に全額返金されます。また、送信時に拒否されたリクエストも課金されません。
いいえ。すべてのメディアは公開されているHTTPS URLである必要があります。事前に独自のオブジェクトストレージにアップロードし、そのリンクを渡してください。
入力画像のアスペクト比に従います（例：正方形の画像の場合は768×768、16:9の画像の場合は1344×768）。テキストのみおよび音声のみのリクエストではadaptiveを使用できません。
1つのクリップが15秒を超えている場合は自動的に先頭の15秒にトリミングされますが、複数の参照動画の合計が15秒を超える場合、タスクは失敗します（返金されます）。
実測値の中央値は約3分で、通常は2〜4分程度です。10〜15秒のクリップはもう少し時間がかかります。
すぐに有効期限切れになることは確認されていませんが、長期的な可用性は保証されていないため、速やかに動画をダウンロードして保存してください。URLの確認にはGETを使用してください。HEADリクエストは403を返します。
まず、リクエストボディがルールに従っていることを確認してください（テキスト項目が厳密に1つのみであること、余分なフィールドがないこと、メディアリンクがhttpsであること）。ルールに従っている場合は通常、一時的な過負荷が原因です。数秒待ってから再試行してください。送信に失敗したリクエストは課金されません。

​
関連ドキュメント