動画生成のための MiniMax H3 API

入力に合った H3 モデルを選ぶ
hailuo_h3:テキスト・開始フレーム・開始終了フレーム
image_url を使った画像から動画、さらに任意の image_end_url を加えた開始・終了フレーム制御には hailuo_h3 を使います。prompt は必須で、最大 7,000 文字です。プレイグラウンドと全パラメータ仕様をご覧ください。
hailuo_h3_refs:参照素材ベースの生成
hailuo_h3_refs を使います。このルートは MiniMax 公式チャネルを経由し、768P と 2K の出力に対応します。参照素材から動画を生成するエンドポイントをご覧ください。
独立した統合 API アクセス

MiniMax H3 API のパラメータと制限
共通エンドポイントと非同期レスポンス
POST https://api.goenhance.ai/api/v1/videos/generations に送信します。レスポンスでは img_uuid が返り、生成は非同期で続きます。hailuo_h3 の長さとプロンプト
duration は 5〜15 秒の整数で、既定値は 5 です。整数でない値や範囲外の値は、ポイントが差し引かれる前に拒否されます。prompt は必須で、最大 7,000 文字です。hailuo_h3 の解像度とアスペクト比
ratio に 21:9、16:9、4:3、1:1、3:4、9:16 を指定できます。image_url で開始フレームを渡した場合、出力はその画像に従い、ratio は使われません。hailuo_h3 のフレーム入力
image_url、終了フレームは任意の image_end_url で渡します。このモデル ID ひとつで、テキストから動画・画像から動画・開始終了フレーム生成のすべてをカバーします。hailuo_h3_refs の参照素材入力
ref_imgs に画像 9 枚、ref_videos に動画 3 本、ref_audios に音声 3 本まで指定できます。長さは 5〜15 秒の整数で既定値は 5、解像度は 768P または 2K です。ネイティブのステレオ音声
MiniMax H3 の秒単価
hailuo_h3 — 480p:1 秒あたり $0.030
hailuo_h3 — 720p:1 秒あたり $0.060
hailuo_h3 — 2K:1 秒あたり $0.090
hailuo_h3_refs — 768P:1 秒あたり $0.099
hailuo_h3_refs — 2K:1 秒あたり $0.143
トークン・返金・同時実行数
MiniMax H3 動画 API を実装する
1. API キーを作成して安全に保管する
Authorization: Bearer <API key> として送信します。ブラウザ側のコードやログには絶対に出さないでください。2. モデルを選び、リクエストを検証する
hailuo_h3、参照素材なら hailuo_h3_refs を選びます。送信前に長さ・解像度・ratio が使えるかどうか・プロンプト長・各入力の件数を検証してください。3. 送信して img_uuid を保存する
https://api.goenhance.ai/api/v1/videos/generations に POST します。タスクは非同期なので、返ってきた img_uuid を自前のジョブレコードに保存してください。4. ポーリングまたはコールバックを受け取る
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... をポーリングするか、コールバック URL を登録します。タスク開始時には status=0 のコールバックが飛び、終了時のコールバックが結果を運びます。5. 検証エラー・生成失敗・同時実行を処理する
開発者が H3 で作っているもの
広告クリエイティブの自動生成
プロダクト動画のパイプライン
多言語向け動画広告
UGC 制作システム
MiniMax H3 API のよくある質問
MiniMax H3 API はどれくらいの長さに対応していますか?
hailuo_h3 と hailuo_h3_refs はどちらも 5〜15 秒の任意の整数を受け付け、既定値は 5 です。整数でない値や範囲外の値は、トークンが差し引かれる前に拒否されます。
H3 のモデル ID が 2 つあるのはなぜですか?
MiniMax はフレーム制御と参照素材を排他として扱います。そのため GoEnhance では、実行時に衝突するパラメータをまとめるのではなく、開始/終了フレームのワークフローに hailuo_h3、参照素材ベースの生成に hailuo_h3_refs を用意しています。
480p と 720p は MiniMax 公式の出力ティアですか?
いいえ。MiniMax が公式に出力するのは 2K のみです。hailuo_h3 の 480p と 720p のティアは GoEnhance 独自のパイプラインで動きます。低コストで試行を重ね、採用するテイクにだけ 2K を使うことができます。
hailuo_h3_refs の料金が高いのはなぜですか?
hailuo_h3_refs は MiniMax 公式チャネルのみを経由します。利用できる解像度は 768P と 2K で、秒単価はそれぞれ $0.099 と $0.143 です。
課金の仕組みを教えてください
課金はトークンベースです。$10 で 500 トークン、1 トークンあたり $0.02。動画は表示された単価で秒単位に課金されます。ポイントはタスク送信時に一度だけ差し引かれ、生成が失敗した場合は全額返金されます。
MiniMax H3 は音声も生成しますか?
はい。H3 はネイティブのステレオによるセリフ・効果音・環境音を、後から吹き替えるのではなく映像と同じ 1 回の生成で出力します。
動画が完成したことはどうすればわかりますか?
返ってきた img_uuid を保存し、ジョブ詳細エンドポイントをポーリングするか、コールバック URL を登録します。開始コールバックは status=0、終了時のコールバックが結果を運びます。
GoEnhance Open API は MiniMax や Hailuo と関係がありますか?
ありません。GoEnhance Open API は独立系のサードパーティ API プラットフォームです。MiniMax でも Hailuo でもなく、MiniMax との資本・提携関係はなく、同社の承認も受けていません。これらの名称はモデルを指すためのもので、各権利者に帰属します。
ノーコードの MiniMax H3 エディタはどこにありますか?
このページは REST API 実装向けです。一般ユーザー向けのエディタをお探しの場合は、MiniMax H3 動画モデルのページをご覧ください。
