MiniMax H3 動画 API:生成と完成動画の再生成
BetterToken API Key で MiniMax H3 に接続し、Model ID と操作に応じたフィールド、素材、生成方法を選びます。
テキスト、先頭・末尾フレーム、参照素材から動画を生成できます。条件に合う自分の 768p H3 完成動画を 2k に再生成することもできます。再生成は元タスクの ID のみを受け付け、新しい素材 URL は受け付けません。
まず BetterToken API Key を用意してください。Base URL は https://bettertoken.ai/v1、認証は Authorization: Bearer YOUR_API_KEY です。Model ID は大文字・小文字も含めて、そのままコピーしてください。
以下の各 request.json は同じ手順で使います。まず見積もりを取得し、確認後に作成、ポーリング、ダウンロードを行います。見積もりでは生成を開始しません。作成すると有料タスクを送信します。現在の料金はモデル広場で確認してください。
モデルと操作
以下の表は操作別の選択肢です。フィールドのデフォルト値、素材数、組み合わせの制約は各節を参照してください。素材サイズは 1 MB = 1048576 バイトで換算しています。
| Model ID | 操作 | 長さ(秒) | 出力設定 | アスペクト比 | 音声 | 素材の役割 |
|---|---|---|---|---|---|---|
MiniMax-H3 | image_to_video | 4–15、1 刻み | 768p、2k | adaptive | provider_default | first_frame、last_frame、reference_image、reference_video、reference_audio |
MiniMax-H3 | reference_to_video | 4–15、1 刻み | 768p、2k | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | provider_default | reference_image、reference_video、reference_audio |
MiniMax-H3 | text_to_video | 4–15、1 刻み | 768p、2k | 21:9、16:9、4:3、1:1、3:4、9:16 | provider_default | なし |
MiniMax-H3 | video_edit | 元タスクを継承 | 2k | adaptive(継承) | provider_default | 元タスク ID |
provider_default はモデルの音声設定を使う指定で、on / off の切り替えはできません。再生成のアスペクト比、長さ、入力は元タスクに基づきます。
サンプル素材
画像からの動画生成と画像参照の例には、白いテーブルの上にある青い陶器のマグカップを使います。そのまま試すか、自分に使用権があり、このページの制限を満たす公開 HTTPS 素材に置き換えてください。

テキストから動画を生成する
MiniMax-H3
テキストの説明だけで動画を生成したい場合に使います。
model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | 4 |
output.aspect_ratio | string | はい | 21:9、16:9、4:3、1:1、3:4、9:16 | なし |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 768p、2k | 768p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
この操作は素材を受け付けません。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "MiniMax-H3", "operation": "text_to_video", "prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "768p", "aspect_ratio": "16:9" }}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
画像から動画を生成する
MiniMax-H3
画像で開始画面、または開始・終了画面を指定したい場合に使います。
model にこの節の Model ID、operation に image_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | 4 |
output.aspect_ratio | string | いいえ | adaptive | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 768p、2k | 768p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
first_frame | image、任意、最大 1 個 | jpg、jpeg、png、webp、heic、heif | サイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px |
last_frame | image、任意、最大 1 個 | jpg、jpeg、png、webp、heic、heif | サイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px |
reference_image | image、任意、最大 9 個 | jpg、jpeg、png、webp、heic、heif | サイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px |
reference_video | video、任意、最大 3 個 | mp4、mov | サイズ上限 50 MB。幅 256–5760 px。高さ 256–5760 px。長さ 2–15 秒。フレームレート下限 23.976 fps、上限 60 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 3 個 | wav、mp3 | サイズ上限 15 MB。長さ 2–15 秒。この役割の合計上限 15 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。first_frame、last_frameのうち少なくとも 1 つを指定してください。- 先頭・末尾フレームは参照画像、参照動画、参照音声と併用できません。先頭・末尾フレームには画像からの動画生成操作、参照素材には参照生成操作を使ってください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "MiniMax-H3", "operation": "image_to_video", "prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "768p", "aspect_ratio": "adaptive" }, "media": [ { "id": "first", "type": "image", "role": "first_frame", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
mutually_exclusive_roles | 先頭・末尾フレームと参照素材を分けて使う。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
参照素材から生成する
MiniMax-H3
参照素材で被写体や動作の特徴を保ちたい場合に使います。
model にこの節の Model ID、operation に reference_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。
| フィールド | 型 | 必須 | 選択肢または範囲 | デフォルト |
|---|---|---|---|---|
audio.mode | string | いいえ | provider_default | provider_default |
duration.mode | string | いいえ | fixed | fixed |
duration.seconds | integer | いいえ | 4–15、1 秒刻み。固定長の場合のみ | 4 |
output.aspect_ratio | string | いいえ | adaptive、21:9、16:9、4:3、1:1、3:4、9:16 | adaptive |
output.format | string | いいえ | mp4 | mp4 |
output.resolution | string | いいえ | 768p、2k | 768p |
prompt | string | はい | 文字列 | なし |
watermark | boolean | いいえ | false、true | false |
素材の要件
| 素材の役割 | 種類と数 | 形式 | ファイルごとの制限 |
|---|---|---|---|
reference_image | image、任意、最大 9 個 | jpg、jpeg、png、webp、heic、heif | サイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px |
reference_video | video、任意、最大 3 個 | mp4、mov | サイズ上限 50 MB。幅 256–5760 px。高さ 256–5760 px。長さ 2–15 秒。フレームレート下限 23.976 fps、上限 60 fps。この役割の合計上限 15 秒 |
reference_audio | audio、任意、最大 3 個 | wav、mp3 | サイズ上限 15 MB。長さ 2–15 秒。この役割の合計上限 15 秒 |
素材が必須かどうかは、以下の組み合わせ制約にも従ってください。
組み合わせの制約
duration.mode="fixed"ではduration.secondsが必須です。fixedを明示する場合は秒数も指定してください。reference_image、reference_video、reference_audioのうち少なくとも 1 つを指定してください。- 先頭・末尾フレームは参照画像、参照動画、参照音声と併用できません。先頭・末尾フレームには画像からの動画生成操作、参照素材には参照生成操作を使ってください。
リクエスト例
以下の JSON を request.json に保存し、共通の手順に従って見積もりを取得し、確認後に作成してください。
{ "model": "MiniMax-H3", "operation": "reference_to_video", "prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.", "duration": { "mode": "fixed", "seconds": 5 }, "output": { "resolution": "768p", "aspect_ratio": "adaptive" }, "media": [ { "id": "reference", "type": "image", "role": "reference_image", "source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png" } ]}よくある 422 エラー
| 422 エラーコード | 対処方法 |
|---|---|
enum / range / step | この節のフィールド表に従って値と刻み幅を調整する。 |
unsupported_field | この操作のフィールド表にないフィールドを削除する。 |
requires | この節の組み合わせ制約に従って秒数、アスペクト比、音声設定、素材を補う。 |
mutually_exclusive_roles | 先頭・末尾フレームと参照素材を分けて使う。 |
count / media_role | この節の素材表に従って役割と数を調整する。 |
video_input_unsupported | 公開 HTTPS URL、Content-Type、ファイル形式を確認し、再度見積もりを取得する。 |
完成動画を再生成する
MiniMax-H3
自分の 768p H3 完成動画があり、元の内容で 2k に再生成したい場合に使います。任意の動画ファイルは受け付けません。
元タスクは次のすべての条件を満たす必要があります。
- 自分のアカウントに属し、Model ID が
MiniMax-H3。 - 生成が成功し、完成動画をまだダウンロードできる。
- 出力設定が
768p。 - 元タスクの作成から 7 日以内。
サーバーは元動画の形式も検査し、条件に合わない場合は 422 video_regeneration_source_invalid を返します。元タスク ID で見積もりを取得してください。動画ファイルを自分で変更して元タスクの代わりに使わないでください。
| リクエストフィールド | 型 | 必須 | 値 |
|---|---|---|---|
model | string | はい | MiniMax-H3 |
operation | string | はい | video_edit |
provider_options.hailuo.source_task_id | string | はい | 条件に合う自分の元タスク ID |
watermark | boolean | いいえ | false / true、デフォルト false |
prompt、duration、output、audio、media は送らないでください。再生成は元タスクの内容と入力を継承し、2k、adaptive、MP4 で出力します。
先に REPLACE_WITH_YOUR_H3_TASK_ID を自分の元タスク ID に置き換えてから、見積もりと作成を行ってください。 新しい有料タスクが作成されるため、新しい状態ファイルを使います。
{ "model": "MiniMax-H3", "operation": "video_edit", "provider_options": { "hailuo": { "source_task_id": "REPLACE_WITH_YOUR_H3_TASK_ID" } }}元タスクが条件に合わない、または存在しない場合、見積もりは 422 video_regeneration_source_invalid を返し、field_path は provider_options.hailuo.source_task_id になります。以下はこのエラーを見分けるための例で、生成には使えません。
{ "model": "MiniMax-H3", "operation": "video_edit", "provider_options": { "hailuo": { "source_task_id": "video_DOES_NOT_EXIST" } }}公式資料
BetterToken を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。

