MiniMax Hailuo H3 動画生成

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}

POST

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}

モデル名は MiniMax-H3 固定です
テキスト動画、先頭/末尾フレーム、画像・動画・音声の複合参照に対応します
出力は 2K、長さは 4-15 秒です
非同期 API は統一形式の generation.task を返します

公開アクセス可能な素材 URL を使用してください。先頭/末尾フレームモードと参照モードは併用できません。参照音声だけの入力もできません。

認証

string

必須

Authorization: Bearer YOUR_API_KEY を送信してください。

リクエストパラメータ

string

デフォルト:"MiniMax-H3"

必須

MiniMax-H3 固定です。

string

必須

動画の説明。最大 7000 文字です。

integer

デフォルト:5

4-15 秒の整数です。

string

デフォルト:"2K"

現在は 2K のみ対応します。

string

デフォルト:"16:9"

21:9、16:9、4:3、1:1、3:4、9:16、adaptive。テキスト動画では adaptive は使えません。フレームモードでは入力画像に自動適応し、参照モードは既定で adaptive です。

string[]

互換用画像 URL。1 枚は先頭、2 枚は先頭/末尾、3-9 枚は参照画像として扱われます。新規実装では image_with_roles を推奨します。

array

url と role を持つ画像配列。role は first_frame（最大 1）、last_frame（最大 1）、reference_image（最大 9）です。 JPG、JPEG、PNG、WebP、HEIC、HEIF、最大 30 MB、各辺 256-5760 px、縦横比 0.4-2.5 に対応します。

array

最大 3 本の参照動画。各項目は url と role: reference_video を持ちます。MP4/MOV、最大 50 MB、各 2-15 秒、合計 15 秒までです。

ToAPIs が実際の動画時間を読み取って課金します。クライアント計算の時間は送信しないでください。

array

最大 3 本の参照音声。各項目は url と role: reference_audio を持ちます。WAV/MP3、最大 15 MB、各 2-15 秒、合計 15 秒までです。

少なくとも 1 つの参照画像または参照動画が必要です。

boolean

デフォルト:false

AIGC ウォーターマークを追加するかどうか。

string

注文 ID などのクライアント側業務 ID。

string

ToAPIs タスク完了 Callback。Webhook を参照してください。

モードと制限

モード	入力	比率
テキスト動画	`prompt`	具体値、既定 `16:9`
先頭/末尾フレーム	`prompt` + フレーム画像	自動 `adaptive`
マルチモーダル参照	`prompt` + 参照素材	既定 `adaptive`

参照素材は画像 9、動画 3、音声 3、合計 12 ファイルまでです。フレーム role と参照 role は混在できません。

例

{
  "model": "MiniMax-H3",
  "prompt": "動画1の動きとカメラリズムを参照し、音声1の声で台詞を話す",
  "duration": 5,
  "resolution": "2K",
  "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}

MiniMax-Hailuo-2.3 Vidu Q3

概要

クイックスタート

チャットAPI

画像API

動画API

タスク管理

ファイルアップロード

アカウント

よくある質問

認証

リクエストパラメータ

モードと制限

例

レスポンス

​認証

​リクエストパラメータ

​モードと制限

​例

​レスポンス

認証

リクエストパラメータ

モードと制限

例

レスポンス