動画生成のための MiniMax H3 API
独立系の GoEnhance Open API を通じて MiniMax H3 を利用できます。テキスト・フレーム画像・参照素材を非同期の REST ワークフローに送信すると img_uuid が返るので、結果をポーリングするかコールバックを登録します。H3 はセリフ・効果音・環境音といったネイティブのステレオ音声を、映像と同じ 1 回の生成で出力します。
API キーを作成
入力に合った H3 モデルを選ぶ
hailuo_h3：テキスト・開始フレーム・開始終了フレーム
テキストから動画、image_url を使った画像から動画、さらに任意の image_end_url を加えた開始・終了フレーム制御には hailuo_h3 を使います。prompt は必須で、最大 7,000 文字です。プレイグラウンドと全パラメータ仕様をご覧ください。
hailuo_h3_refs：参照素材ベースの生成
1 リクエストで最大 9 枚の参照画像、3 本の参照動画、3 本の参照音声が必要な場合は hailuo_h3_refs を使います。このルートは MiniMax 公式チャネルを経由し、768P と 2K の出力に対応します。参照素材から動画を生成するエンドポイントをご覧ください。
独立した統合 API アクセス
GoEnhance Open API は、動画・画像モデルへの統合アクセスを提供する独立系のサードパーティプラットフォームです。MiniMax でも Hailuo でもなく、MiniMax との資本・提携関係はなく、同社の承認も受けていません。MiniMax および Hailuo は各権利者の商標であり、ここではモデルを指す目的でのみ使用しています。
送信前にこれらの項目を検証しておけば、不正なリクエストはポイントが引かれる前に弾かれます。
MiniMax H3 API のパラメータと制限
共通エンドポイントと非同期レスポンス
どちらのモデルも <code>POST https://api.goenhance.ai/api/v1/videos/generations</code> に送信します。レスポンスでは <code>img_uuid</code> が返り、生成は非同期で続きます。
hailuo_h3 の長さとプロンプト
<code>duration</code> は 5〜15 秒の整数で、既定値は 5 です。整数でない値や範囲外の値は、ポイントが差し引かれる前に拒否されます。<code>prompt</code> は必須で、最大 7,000 文字です。
hailuo_h3 の解像度とアスペクト比
480p、720p、2K から選べます。テキストから動画の場合のみ <code>ratio</code> に 21:9、16:9、4:3、1:1、3:4、9:16 を指定できます。<code>image_url</code> で開始フレームを渡した場合、出力はその画像に従い、ratio は使われません。
hailuo_h3 のフレーム入力
開始フレームは <code>image_url</code>、終了フレームは任意の <code>image_end_url</code> で渡します。このモデル ID ひとつで、テキストから動画・画像から動画・開始終了フレーム生成のすべてをカバーします。
hailuo_h3_refs の参照素材入力
1 リクエストにつき <code>ref_imgs</code> に画像 9 枚、<code>ref_videos</code> に動画 3 本、<code>ref_audios</code> に音声 3 本まで指定できます。長さは 5〜15 秒の整数で既定値は 5、解像度は 768P または 2K です。
ネイティブのステレオ音声
H3 はセリフ・効果音・環境音を、後から吹き替えるのではなく映像と同じ 1 回の生成でネイティブのステレオ音声として出力します。
1 回あたりの費用は、選んだティアの秒単価 × リクエストした出力秒数です。動画モデルは出力秒数で課金されます。
MiniMax H3 の秒単価
hailuo_h3 — 480p：1 秒あたり $0.030
低コストでプロンプトを試行するための GoEnhance 独自パイプラインのティアです。MiniMax が公式にサポートする出力ティアではありません。
hailuo_h3 — 720p：1 秒あたり $0.060
本番テイクを選ぶ前に低コストで試すための GoEnhance 独自パイプラインのティアです。MiniMax が公式にサポートする出力ティアではありません。
hailuo_h3 — 2K：1 秒あたり $0.090
MiniMax 公式の出力解像度が必要な採用テイクには 2K ティアを使います。
hailuo_h3_refs — 768P：1 秒あたり $0.099
参照素材ベースの生成は MiniMax 公式チャネルのみを経由するため、ティアと料金が異なります。
hailuo_h3_refs — 2K：1 秒あたり $0.143
参照素材ベースのリクエスト向けの、2K 公式チャネルティアです。
トークン・返金・同時実行数
利用量はトークン単位で課金されます。$10 で 500 トークン、1 トークンあたり $0.02 です。ポイントは送信時に一度だけ差し引かれ、生成が失敗した場合は全額返金されます。同時実行数はアカウントの Build Tier によって決まり、未完了タスク 3 件から始まります。<a href="/billing">料金ティアとクレジット</a>をご確認ください。
MiniMax H3 動画 API を実装する
1
1. API キーを作成して安全に保管する
/keys でキーを作成し、
Authorization: Bearer <API key> として送信します。ブラウザ側のコードやログには絶対に出さないでください。 2
2. モデルを選び、リクエストを検証する
テキストやフレーム制御なら
hailuo_h3、参照素材なら hailuo_h3_refs を選びます。送信前に長さ・解像度・ratio が使えるかどうか・プロンプト長・各入力の件数を検証してください。 3
3. 送信して img_uuid を保存する
リクエストを
https://api.goenhance.ai/api/v1/videos/generations に POST します。タスクは非同期なので、返ってきた img_uuid を自前のジョブレコードに保存してください。 4
4. ポーリングまたはコールバックを受け取る
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... をポーリングするか、コールバック URL を登録します。タスク開始時には status=0 のコールバックが飛び、終了時のコールバックが結果を運びます。 5
5. 検証エラー・生成失敗・同時実行を処理する
不正な長さや両立しない入力の組み合わせを、そのまま再送しないでください。生成が失敗した場合は全額返金されます。未完了タスクが Build Tier の同時実行上限に達したら、新しい送信はキューに入れてください。
非同期ジョブ、ネイティブ音声、明示的なフレーム／参照入力を軸に、繰り返し使えるメディアパイプラインを構築できます。
開発者が H3 で作っているもの
広告クリエイティブの自動生成
構造化したプロンプトから短尺のキャンペーン案をまとめて生成し、承認されたものだけを残します。
プロダクト動画のパイプライン
商品画像を開始フレームにして、その画像のアスペクト比に沿った短尺クリップを生成します。
多言語向け動画広告
映像・セリフ・効果音・環境音を 1 回で生成し、各結果をローカライズとレビューのワークフローに流します。
UGC 制作システム
投稿受付・ジョブ管理・コールバック・モデレーション・素材保管をつなぎ、短尺コンテンツの制作を自動化します。
制限、モデルの使い分け、課金、音声、そしてプラットフォームとの関係について。