テキストから動画
被写体、動作、カメラ、照明、音を書きます。H3がその内容を、1つの完成した動画シーンに仕上げます。
認証済みのお客様は、minimax3.comのAPIキーを作成し、サイトと同じクレジットをサーバー、スクリプト、アプリケーションから使えます。APIは非同期です。まずタスクを作成し、動画ができあがるまでステータスをポーリングします。
アカウントの「APIキー」を開き、シークレットキーが表示されたら、その場でコピーします。
一意の Idempotency-Key ヘッダーを付けて、POST リクエストを送信します。
ステータスが succeeded に変わるまで、約5秒ごとにタスクのURLへリクエストします。
/api/v1/videos動画タスクを作成
/api/v1/videos/{task_id}タスクの取得・一覧
/api/v1/videosタスクの取得・一覧
/api/v1/videos/{task_id}/content完成した動画を、同じAPIキー(Bearer)でダウンロード
動画を作成するときは、必ず一意の Idempotency-Key を送ってください。同じ Idempotency-Key で同じリクエストを再送すると、クレジットを二重に消費することなく、元のタスクが返されます。返される video_url は非公開のため、ダウンロード時も同じAPIキーをBearerトークンとして付けてください。
curl -X POST https://minimax3.com/api/v1/videos \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: product-demo-001" \
-d '{
"model": "minimax-h3",
"mode": "text-to-video",
"prompt": "A cinematic product reveal with a slow camera move",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "2K"
}'const response = await fetch('https://minimax3.com/api/v1/videos', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.MINIMAX3_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
model: 'minimax-h3',
mode: 'text-to-video',
prompt: 'A cinematic product reveal with a slow camera move',
duration: 5,
aspect_ratio: '16:9',
resolution: '2K',
}),
});
const task = await response.json();
console.log(task.id, task.status);import os
import uuid
import requests
response = requests.post(
"https://minimax3.com/api/v1/videos",
headers={
"Authorization": f"Bearer {os.environ['MINIMAX3_API_KEY']}",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"model": "minimax-h3",
"mode": "text-to-video",
"prompt": "A cinematic product reveal with a slow camera move",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "2K",
},
)
task = response.json()
print(task["id"], task["status"])curl https://minimax3.com/api/v1/videos/TASK_ID \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY"curl -L https://minimax3.com/api/v1/videos/TASK_ID/content \
-H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
--output minimax-h3.mp4| フィールド | 必須 | 説明 |
|---|---|---|
| model | 必須 | minimax-h3 を指定します。 |
| mode | 必須 | text-to-video、image-to-video、reference-to-video のいずれか。 |
| prompt | 必須 | 動画の説明。最大7,000文字。 |
| duration | 任意 | 4〜15秒の整数。デフォルトは5。 |
| aspect_ratio | 任意 | 21:9、16:9、4:3、1:1、3:4、9:16 のいずれか。 |
| resolution | 任意 | 2Kを指定できます。 |
| image_url | モードによる | image-to-video で使う開始画像のHTTPS URL。 |
| last_frame_url | 任意 | 最後のフレームに使う画像のHTTPS URL(任意)。 |
| reference_image_urls | モードによる | 参照画像のHTTPS URL。最大9件。 |
アイデアに合った入力を選んでください。MiniMax H3は、プロンプトからシーンを組み立てることも、手持ちの画像を動かすことも、参照画像で見た目をそろえることもできます。
被写体、動作、カメラ、照明、音を書きます。H3がその内容を、1つの完成した動画シーンに仕上げます。
開始画像をアップロードし、シーンをどう動かすかをH3に伝えます。最後のフレームを追加して、さらに細かく制御することもできます。
キャラクター、商品、構図、ビジュアルスタイルをひと目でわかるように保ちたいときは、参照画像を追加します。
クリエイティブな判断に集中できます。生成ジョブの処理、進捗の管理、結果の保存、対象となるクレジットの返還は、当サイトが裏側で行います。
テキストか画像のモードを選び、プロンプトを書きます。
4〜15秒の長さを選び、2K動画の生成を始めます。
進捗と完成した動画は、「マイ作品」で確認できます。
動画をダウンロードしたり、プロンプトを練り直したり、別のアイデアを試したりできます。
使えるプロンプトは、被写体、動作、環境、カメラ、照明、テンポ、音を組み合わせたものです。最も重要な条件は前のほうに書き、矛盾する指示は避けましょう。
はい。MiniMax H3を使って、テキストから動画・画像から動画の2Kジョブを、4〜15秒の長さで作成できます。
サイト上での生成にAPIキーは不要です。開発者はアカウント設定からminimax3.comのAPIキーを作成し、サイトと同じクレジットをプログラムから使えます。
当サイトでは、H3の生成で消費するクレジットは主に動画の長さで決まります。生成前に料金ページで現在のクレジットプランを確認し、使い方に合ったものを選んでください。
いいえ。H3 MaxはH3の公開ウェイトをもとに追加学習した別のモデルで、連続生成のDirectorモードが加わっています。768P・5秒のクリップを3秒未満で生成できますが、2Kモードはありません。一方、当サイトで使っているMiniMax H3 APIは2Kまで対応しています。
まだできません。ここでの生成はMiniMax H3で、最大2Kです。それまでの間は、当サイトのH3 Max解説ページで、エンドポイント、秒単位の料金、Directorセッションの最低60秒を確認できます。
はい。支払い履歴のある認証済みのお客様は、APIキーを作成して POST /api/v1/videos を呼び出し、GET /api/v1/videos/{task_id} で結果を取得できます。
失敗したジョブを記録し、サイトのクレジット規定に従って、消費したクレジットの自動返還を試みます。