MiniMax H3
共用の AI 動画生成エンドポイントにおける MiniMax H3 固有のモデル、制限、料金。
MiniMax H3 は共用の動画生成エンドポイント上で動作します。エンドポイント本体、リクエストの流れ、入力コンテンツ、ポーリング、タスク一覧、エラーコードについては AI 動画の概要 を参照してください。このページでは MiniMax H3 固有の内容だけを扱います。
モデル
| モデル | 適した用途 | レート制限 |
|---|---|---|
MiniMax-H3 | 音声付きの動画。最後のフレーム単独指定と参考音声に対応 | 5 RPM |
POST /v1/video-generation/generate の model フィールドにモデル名を渡します。リテラルは大文字小文字を区別します（MiniMax-H3）。
制限
| 制限項目 | MiniMax H3 |
|---|---|
| 解像度 | 768p、2k |
| 長さ | 4-15 秒（整数秒のみ） |
| アスペクト比 | 16:9、4:3、1:1、3:4、9:16、21:9 |
| プロンプト長 | 最大 2500 文字、必須 |
| 参考画像 | 1 リクエストにつき最大 5 枚 |
| 参考動画 | 1 リクエストにつき最大 3 本 |
| 参考音声 | 1 リクエストにつき最大 3 本 |
inputVideoDuration | 2-15 秒。参考動画を渡す場合は必須 |
768p は短辺を 768 ピクセルに合わせます（16:9 なら 1344×768）。2k は長辺を 2560 ピクセルに合わせます。どちらも MiniMax H3 専用で、共用エンドポイント上の他のモデルは受け付けません。逆に MiniMax H3 は 480p、720p、1080p を受け付けません。
MiniMax H3 は first_frame、last_frame、およびその両方を受け付けます。このエンドポイントで last_frame を単独で渡せる唯一のモデルです。他のモデルでは最後のフレームは最初のフレームとセットでしか指定できないため、「このカットで終わらせたい」という指定に、埋め合わせの最初のフレームを用意する必要がありません。フレーム系のロールと参考系のロール（reference_image、reference_video、reference_audio）を同一リクエストで併用することはできません。
画像から動画の場合、アスペクト比は入力画像から導出されるため、ratio は受け付けられたうえで無視されます。構図はパラメータではなく、渡す画像のトリミングで決めてください。
MiniMax H3 が受け付ける解像度は 768p と 2k だけです。480p、720p、1080p
は 400 を返し、768p と 2k を受け付けるモデルも他にありません。長さは 4-15
秒です。4:5 と 5:4 は拒否され、画像から動画では ratio 自体が無視されます。
seed と generateAudio は互換性のために受け付けますが効果はありません。生成結果は
seed で再現できず、出力には必ず音声が入ります。reference_image の上限は 1
リクエストにつき 5 枚で、共用エンドポイントの他モデルの 9 枚とは異なります。
料金
クレジットは解像度と長さに応じて増えます。合計は整数クレジットに切り上げられます。
| 解像度 | クレジット / 秒 | 4 秒 | 10 秒 | 15 秒 |
|---|---|---|---|---|
768p | 9.3075 | 38 | 94 | 140 |
2k | 15.1247 | 61 | 152 | 227 |
生成前に正確な金額を知るには、MiniMax H3 の model、resolution、duration を指定して POST /v1/video-generation/estimate-credits を呼び出してください。クレジットはタスク作成時に消費され、失敗時は自動で返却されます。
例
curl -X POST "https://api.marswave.ai/openapi/v1/video-generation/generate" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{ "type": "text", "text": "The camera pushes in slowly as the city lights come up" },
{ "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/open.jpg" } },
{ "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/close.jpg" } }
],
"resolution": "768p",
"ratio": "16:9",
"duration": 8
}'完全なパラメータ一覧と、テキストから動画 / 画像から動画のリクエスト構造については AI 動画の概要 を参照してください。