Minimax H3 Text-to-Video テキストから動画
- 空でないテキストプロンプトから動画を生成
- 出力時間は
5~15秒、現在は2kのみ対応 - 画像・動画・音声入力は非対応
- 非同期処理。返されたタスク ID で状態を照会
- 生成 URL の有効期間は 24 時間です
承認
ボディ
動画生成モデル名
minimax-h3-text-to-video "minimax-h3-text-to-video"
生成したい動画の内容をテキストで記述します。
プロンプト要件:
- 必須で、空文字列は使用できません
- 中国語と英語に対応しています
- 中国語は
500文字以内、英語は1000語以内を推奨します。長すぎるプロンプトでは一部の詳細が無視される場合があります
入力制限:
- このモデルはテキストから動画を生成し、テキスト入力のみを受け付けます
image_start、image_end、image_urls、video_urls、audio_urlsは使用できません- これらのメディアフィールドを指定するとパラメータエラーになります
1"壮大なスペースオペラ映画の予告編。女性艦長が巨大な観測窓の前に一人で立ち、窓の外では最後の艦隊が集結している。艦隊がまばゆい閃光とともにワープし、艦橋が激しく揺れる。光が消えると、彼女だけが静かな宇宙に取り残される。映画的な照明、ゆっくりとしたドリーイン、壮大で抑制された雰囲気。"
出力動画の長さ(秒)。デフォルトは 5 秒です。
値の制限:
5~15の整数のみ使用できます(境界値を含む)- 小数、数字文字列、
auto、-1は使用できません - 出力時間は料金に直接影響します
5 <= x <= 155
出力動画の解像度。デフォルトは 2k です。
使用可能な値:
2k:現在使用できる唯一の解像度
注意:
768pはまだ提供されておらず、指定するとパラメータエラーになります- 出力ビットレート、フレームレート、動画コーデック、音声コーデックはプラットフォームが決定し、リクエストでは設定できません
2k "2k"
出力動画のアスペクト比。デフォルトは adaptive です。
使用可能な値:
adaptive:プロンプトに基づいて適切な比率を自動選択21:9:ウルトラワイド16:9:横長4:3:標準横長1:1:正方形3:4:標準縦長9:16:縦長
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 "adaptive"
タスク完了後の HTTPS コールバックアドレス
コールバックタイミング:
- タスク完了(completed)または失敗(failed)時にトリガー
- 課金確認完了後に送信
セキュリティ制限:
- HTTPS プロトコルのみ対応
- プライベートIPアドレスへのコールバックは禁止(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x など)
- URL の長さは
2048文字以内
コールバックメカニズム:
- タイムアウト:
10秒 - 失敗後最大
3回リトライ(失敗後1/2/4秒でそれぞれリトライ) - コールバックレスポンスボディのフォーマットはタスク照会APIの返却フォーマットと同一
- 2xx ステータスコードを成功とみなし、その他のステータスコードでリトライをトリガー
^https://"https://your-domain.com/webhooks/video-task-completed"
レスポンス
動画生成タスクの作成に成功
タスク作成タイムスタンプ
1761313744
タスクID
"task-unified-1774857405-abc123"
実際に使用されたモデル名
"minimax-h3-text-to-video"
タスクの具体的なタイプ
video.generation.task タスク進捗パーセンテージ (0-100)
0 <= x <= 1000
タスクステータス
pending, processing, completed, failed "pending"
動画タスクの詳細情報
タスクの出力タイプ
text, image, audio, video "video"
使用量と課金情報