動画生成のための 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 の出力に対応します。参照素材から動画を生成するエンドポイントをご覧ください。
hailuo_h3_refs:参照素材ベースの生成

独立した統合 API アクセス

GoEnhance Open API は、動画・画像モデルへの統合アクセスを提供する独立系のサードパーティプラットフォームです。MiniMax でも Hailuo でもなく、MiniMax との資本・提携関係はなく、同社の承認も受けていません。MiniMax および Hailuo は各権利者の商標であり、ここではモデルを指す目的でのみ使用しています。
独立した統合 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 の解像度とアスペクト比

480p、720p、2K から選べます。テキストから動画の場合のみ 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 の参照素材入力

1 リクエストにつき ref_imgs に画像 9 枚、ref_videos に動画 3 本、ref_audios に音声 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 件から始まります。料金ティアとクレジットをご確認ください。

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 の同時実行上限に達したら、新しい送信はキューに入れてください。
API キーを作成
非同期ジョブ、ネイティブ音声、明示的なフレーム/参照入力を軸に、繰り返し使えるメディアパイプラインを構築できます。

開発者が H3 で作っているもの

広告クリエイティブの自動生成

構造化したプロンプトから短尺のキャンペーン案をまとめて生成し、承認されたものだけを残します。

プロダクト動画のパイプライン

商品画像を開始フレームにして、その画像のアスペクト比に沿った短尺クリップを生成します。

多言語向け動画広告

映像・セリフ・効果音・環境音を 1 回で生成し、各結果をローカライズとレビューのワークフローに流します。

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 動画モデルのページをご覧ください。

MiniMax H3 API の実装を始める