curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"MiniMax-H3","prompt":"月面の宇宙飛行士をカメラがゆっくり捉える","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-H3",
"prompt": "画像1の人物を維持し、動画1の動きとカメラを参照し、音声1の声で台詞を話す",
"duration": 5,
"resolution": "2K",
"aspect_ratio": "adaptive",
"image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
"video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
"audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
}'
{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}
MiniMax-H3
MiniMax Hailuo H3 動画生成
MiniMax Hailuo H3 でテキスト、先頭・末尾フレーム、マルチモーダル参照から 2K または 768p 動画を生成
POST
/
v1
/
videos
/
generations
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"MiniMax-H3","prompt":"月面の宇宙飛行士をカメラがゆっくり捉える","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-H3",
"prompt": "画像1の人物を維持し、動画1の動きとカメラを参照し、音声1の声で台詞を話す",
"duration": 5,
"resolution": "2K",
"aspect_ratio": "adaptive",
"image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
"video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
"audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
}'
{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}
中国本土のユーザー向け： 中国本土のユーザーは
https://toapis.cn を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。MiniMax-H3、MiniMax-H3-Max、MiniMax-H3-Max-Turboの3モデルに対応しますMiniMax-H3とMiniMax-H3-Maxはテキスト動画、先頭/末尾フレーム、画像・動画・音声の複合参照に対応しますMiniMax-H3-Max-Turboはテキスト動画と先頭/末尾フレームのみに対応し、参照素材には対応しません- 旧 H3 は
2K/768p、4-15秒。Max / Max-Turbo は480P/768P、5-15秒です - 非同期 API は統一形式の
generation.taskを返します
MiniMax-H3-Max-Turbo は reference_image、reference_video、reference_audio に対応しません。参照素材を送信すると MiniMax-H3-Max-Turbo does not support reference media が返されます。参照動画を使う場合は MiniMax-H3 または MiniMax-H3-Max を選択してください。公開アクセス可能な素材 URL を使用してください。先頭/末尾フレームモードと参照モードは併用できません。参照音声だけの入力もできません。
認証
string
必須
Authorization: Bearer YOUR_API_KEY を送信してください。リクエストパラメータ
string
デフォルト:"MiniMax-H3"
必須
MiniMax-H3、MiniMax-H3-Max、MiniMax-H3-Max-Turbo から選択します。マルチモーダル参照は MiniMax-H3 と MiniMax-H3-Max のみが対応します。Turbo はテキスト動画と先頭/末尾フレームのみに対応します。string
必須
動画の説明。最大
7000 文字です。integer
デフォルト:5
MiniMax-H3 は 4-15 秒、Max / Max-Turbo は 5-15 秒の整数に対応します。string
デフォルト:"2K"
MiniMax-H3 は 2K と 768p、Max / Max-Turbo は 480P と 768P に対応します。string
デフォルト:"16:9"
21:9、16:9、4:3、1:1、3:4、9:16、adaptive。
テキスト動画では adaptive は使えません。フレームモードでは入力画像に自動適応し、参照モードは既定で adaptive です。
参照モードは MiniMax-H3 と MiniMax-H3-Max のみが対応します。string[]
互換用画像 URL。1 枚は先頭、2 枚は先頭/末尾、3-9 枚は参照画像として扱われます。新規実装では
image_with_roles を推奨します。
3-9 枚の参照画像入力は MiniMax-H3 と MiniMax-H3-Max のみが対応し、Turbo では使用できません。array
url と role を持つ画像配列。role は first_frame（最大 1）、last_frame（最大 1）、reference_image（最大 9）です。
reference_image は MiniMax-H3 と MiniMax-H3-Max のみが対応します。Turbo では first_frame と last_frame のみ使用できます。
JPG、JPEG、PNG、WebP、HEIC、HEIF、最大 30 MB、各辺 256-5760 px、縦横比 0.4-2.5 に対応します。array
MiniMax-H3 と MiniMax-H3-Max のみが対応し、Turbo では使用できません。
最大 3 本の参照動画。各項目は url と role: reference_video を持ちます。MP4/MOV、最大 50 MB、各 2-15 秒、合計 15 秒までです。
ToAPIs が実際の動画時間を読み取って課金します。クライアント計算の時間は送信しないでください。
array
MiniMax-H3 と MiniMax-H3-Max のみが対応し、Turbo では使用できません。
最大 3 本の参照音声。各項目は url と role: reference_audio を持ちます。WAV/MP3、最大 15 MB、各 2-15 秒、合計 15 秒までです。
少なくとも 1 つの参照画像または参照動画が必要です。
boolean
デフォルト:false
AIGC ウォーターマークを追加するかどうか。
string
注文 ID などのクライアント側業務 ID。
モードと制限
| モード | 対応モデル | 入力 | 比率 |
|---|---|---|---|
| テキスト動画 | 全 3 モデル | prompt | 具体値、既定 16:9 |
| 先頭/末尾フレーム | 全 3 モデル | prompt + フレーム画像 | 自動 adaptive |
| マルチモーダル参照 | MiniMax-H3 と MiniMax-H3-Max のみ | prompt + 参照素材 | 既定 adaptive |
MiniMax-H3 と MiniMax-H3-Max にのみ適用されます。
参照素材は画像 9、動画 3、音声 3、合計 12 ファイルまでです。フレーム role と参照 role は混在できません。
例
参照素材の例はMiniMax-H3 を使用しています。model を MiniMax-H3-Max-Turbo に置き換えるだけでは使用できません。MiniMax-H3-Max を使用する場合は、resolution を 480P または 768P、duration を 5-15 秒に設定してください。
{
"model": "MiniMax-H3",
"prompt": "動画1の動きとカメラリズムを参照し、音声1の声で台詞を話す",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "adaptive",
"video_with_roles": [
{"url": "https://example.com/motion.mp4", "role": "reference_video"}
],
"audio_with_roles": [
{"url": "https://example.com/voice.mp3", "role": "reference_audio"}
]
}
レスポンス
string
ToAPIs タスク ID。
string
generation.task 固定。string
MiniMax-H3 固定。string
queued、in_progress、completed、failed。integer
0-100 の進捗。integer
Unix 作成時刻（秒）。
動画タスク状態取得をポーリングしてください。完了時の URL は
result.data[0].url にあります。curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{"model":"MiniMax-H3","prompt":"月面の宇宙飛行士をカメラがゆっくり捉える","duration":5,"resolution":"2K","aspect_ratio":"16:9"}'
curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "MiniMax-H3",
"prompt": "画像1の人物を維持し、動画1の動きとカメラを参照し、音声1の声で台詞を話す",
"duration": 5,
"resolution": "2K",
"aspect_ratio": "adaptive",
"image_with_roles": [{"url": "https://example.com/person.png", "role": "reference_image"}],
"video_with_roles": [{"url": "https://example.com/motion.mp4", "role": "reference_video"}],
"audio_with_roles": [{"url": "https://example.com/voice.mp3", "role": "reference_audio"}]
}'
{"id":"vid_01KZ3H3EXAMPLE00000000000","object":"generation.task","model":"MiniMax-H3","status":"queued","progress":0,"created_at":1785729000}