コンテンツにスキップ
無料で登録
MiniMax H3

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-H3image_to_video4–15、1 刻み768p、2kadaptiveprovider_defaultfirst_frame、last_frame、reference_image、reference_video、reference_audio
MiniMax-H3reference_to_video4–15、1 刻み768p、2kadaptive、21:9、16:9、4:3、1:1、3:4、9:16provider_defaultreference_image、reference_video、reference_audio
MiniMax-H3text_to_video4–15、1 刻み768p、2k21:9、16:9、4:3、1:1、3:4、9:16provider_defaultなし
MiniMax-H3video_edit元タスクを継承2kadaptive(継承)provider_default元タスク ID

provider_default はモデルの音声設定を使う指定で、on / off の切り替えはできません。再生成のアスペクト比、長さ、入力は元タスクに基づきます。

サンプル素材

画像からの動画生成と画像参照の例には、白いテーブルの上にある青い陶器のマグカップを使います。そのまま試すか、自分に使用権があり、このページの制限を満たす公開 HTTPS 素材に置き換えてください。

動画生成の参照画像:白いテーブルの上にある青い陶器のマグカップ

テキストから動画を生成する

MiniMax-H3

テキストの説明だけで動画を生成したい場合に使います。

model にこの節の Model ID、operation に text_to_video を設定します。生成フィールドは以下の表にあるものだけを使い、素材は media 配列に入れてください。

フィールド型必須選択肢または範囲デフォルト
audio.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみ4
output.aspect_ratiostringはい21:9、16:9、4:3、1:1、3:4、9:16なし
output.formatstringいいえmp4mp4
output.resolutionstringいいえ768p、2k768p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

この操作は素材を受け付けません。

組み合わせの制約

  • 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.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみ4
output.aspect_ratiostringいいえadaptiveadaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ768p、2k768p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
first_frameimage、任意、最大 1 個jpg、jpeg、png、webp、heic、heifサイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px
last_frameimage、任意、最大 1 個jpg、jpeg、png、webp、heic、heifサイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px
reference_imageimage、任意、最大 9 個jpg、jpeg、png、webp、heic、heifサイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px
reference_videovideo、任意、最大 3 個mp4、movサイズ上限 50 MB。幅 256–5760 px。高さ 256–5760 px。長さ 2–15 秒。フレームレート下限 23.976 fps、上限 60 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 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.modestringいいえprovider_defaultprovider_default
duration.modestringいいえfixedfixed
duration.secondsintegerいいえ4–15、1 秒刻み。固定長の場合のみ4
output.aspect_ratiostringいいえadaptive、21:9、16:9、4:3、1:1、3:4、9:16adaptive
output.formatstringいいえmp4mp4
output.resolutionstringいいえ768p、2k768p
promptstringはい文字列なし
watermarkbooleanいいえfalse、truefalse

素材の要件

素材の役割種類と数形式ファイルごとの制限
reference_imageimage、任意、最大 9 個jpg、jpeg、png、webp、heic、heifサイズ上限 30 MB。幅 256–5760 px。高さ 256–5760 px
reference_videovideo、任意、最大 3 個mp4、movサイズ上限 50 MB。幅 256–5760 px。高さ 256–5760 px。長さ 2–15 秒。フレームレート下限 23.976 fps、上限 60 fps。この役割の合計上限 15 秒
reference_audioaudio、任意、最大 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 で見積もりを取得してください。動画ファイルを自分で変更して元タスクの代わりに使わないでください。

リクエストフィールド型必須値
modelstringはいMiniMax-H3
operationstringはいvideo_edit
provider_options.hailuo.source_task_idstringはい条件に合う自分の元タスク ID
watermarkbooleanいいえ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 を呼び出す際は、このページのフィールドとリアルタイムのモデルカタログで該当する操作を確認してください。