Skip to main content
POST
Minimax H3 Text-to-Video テキストから動画

承認

Authorization
string
header
必須

##すべてのAPIはBearer Tokenによる認証が必要です##

APIキーの取得:

APIキー管理ページ にアクセスしてAPIキーを取得してください

リクエストヘッダーに以下を追加:

ボディ

application/json
model
enum<string>
デフォルト:minimax-h3-text-to-video
必須

動画生成モデル名

利用可能なオプション:
minimax-h3-text-to-video
:

"minimax-h3-text-to-video"

prompt
string
必須

生成したい動画の内容をテキストで記述します。

プロンプト要件:

  • 必須で、空文字列は使用できません
  • 中国語と英語に対応しています
  • 中国語は 500 文字以内、英語は 1000 語以内を推奨します。長すぎるプロンプトでは一部の詳細が無視される場合があります

入力制限:

  • このモデルはテキストから動画を生成し、テキスト入力のみを受け付けます
  • image_startimage_endimage_urlsvideo_urlsaudio_urls は使用できません
  • これらのメディアフィールドを指定するとパラメータエラーになります
Minimum string length: 1
:

"壮大なスペースオペラ映画の予告編。女性艦長が巨大な観測窓の前に一人で立ち、窓の外では最後の艦隊が集結している。艦隊がまばゆい閃光とともにワープし、艦橋が激しく揺れる。光が消えると、彼女だけが静かな宇宙に取り残される。映画的な照明、ゆっくりとしたドリーイン、壮大で抑制された雰囲気。"

duration
integer
デフォルト:5

出力動画の長さ(秒)。デフォルトは 5 秒です。

値の制限:

  • 515 の整数のみ使用できます(境界値を含む)
  • 小数、数字文字列、auto-1 は使用できません
  • 出力時間は料金に直接影響します
必須範囲: 5 <= x <= 15
:

5

quality
enum<string>
デフォルト:2k

出力動画の解像度。デフォルトは 2k です。

使用可能な値:

  • 2k:現在使用できる唯一の解像度

注意:

  • 768p はまだ提供されておらず、指定するとパラメータエラーになります
  • 出力ビットレート、フレームレート、動画コーデック、音声コーデックはプラットフォームが決定し、リクエストでは設定できません
利用可能なオプション:
2k
:

"2k"

aspect_ratio
enum<string>
デフォルト:adaptive

出力動画のアスペクト比。デフォルトは 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"

callback_url
string<uri>

タスク完了後の 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 ステータスコードを成功とみなし、その他のステータスコードでリトライをトリガー
Pattern: ^https://
:

"https://your-domain.com/webhooks/video-task-completed"

レスポンス

動画生成タスクの作成に成功

created
integer

タスク作成タイムスタンプ

:

1761313744

id
string

タスクID

:

"task-unified-1774857405-abc123"

model
string

実際に使用されたモデル名

:

"minimax-h3-text-to-video"

object
enum<string>

タスクの具体的なタイプ

利用可能なオプション:
video.generation.task
progress
integer

タスク進捗パーセンテージ (0-100)

必須範囲: 0 <= x <= 100
:

0

status
enum<string>

タスクステータス

利用可能なオプション:
pending,
processing,
completed,
failed
:

"pending"

task_info
object

動画タスクの詳細情報

type
enum<string>

タスクの出力タイプ

利用可能なオプション:
text,
image,
audio,
video
:

"video"

usage
object

使用量と課金情報