MiniMax H3 API
MiniMax H3 動画生成モデルの完全な API リファレンスです。
モデルバリエーション {#}
この API は、3 つのモデルバリエーションをサポートしています。
クイック比較
サポートされるアスペクト比
テキストから動画と参照素材から動画では、以下をサポートしています。
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
解像度オプション
MiniMax H3 テキストから動画
エンドポイント
POST /api/v1/video/task
リクエストパラメーター
必須
リクエスト例
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model_name: 'minimax-h3-text-to-video',
prompt: '陽光に照らされた草原を走るゴールデンレトリバー',
duration: 8,
resolution: '2k',
aspect_ratio: '16:9'
})
});
const { data } = await response.json();
const taskId = data.task_id;
MiniMax H3 画像から動画
エンドポイント
POST /api/v1/video/task
リクエストパラメーター
必須
オプション
注： 画像から動画は aspect_ratio をサポートしていません。
リクエスト例
{
model_name: 'minimax-h3-image-to-video',
image_url: 'https://example.com/first-frame.jpg',
image_end_url: 'https://example.com/last-frame.jpg',
prompt: 'カメラがゆっくりと後退し、風景全体を映し出す',
duration: 8,
resolution: '2k'
}
MiniMax H3 参照素材から動画
オプションの画像、動画、音声の参照素材から新しい動画を生成します。
エンドポイント
POST /api/v1/video/task
リクエストパラメーター
必須
参照メディア
@（AT）参照プレースホルダー
@（AT）参照機能は、番号付きの <<<...>>> プレースホルダーを介して参照メディアをプロンプトにリンクします。番号はメディアタイプごとに個別に 1 から始まり、対応する配列の順序に従います。
たとえば、最初の画像がキャラクターの参照画像で、2 番目の画像がシーンの参照画像である場合、prompt 内でキャラクターには <<<image_1>>>、シーンには <<<image_2>>> を使用します。各プレースホルダーは、対応する配列に存在する項目を指す必要があります。
リクエスト例
{
model_name: 'minimax-h3-reference-to-video',
prompt: '画像 1 を被写体に、動画 1 を動きに、音声 1 を雰囲気に使用する',
duration: 8,
resolution: '2k',
aspect_ratio: '16:9',
images: ['https://example.com/subject-reference.jpg'],
videos: ['https://example.com/motion-reference.mp4'],
audios: ['https://example.com/atmosphere-reference.mp3']
}
@（AT）参照素材から動画のリクエスト例
{
model_name: 'minimax-h3-reference-to-video',
prompt: '<<<image_1>>> の探検家を <<<image_2>>> の環境に配置し、<<<video_1>>> のカメラの動きに従わせ、<<<audio_1>>> の参照音声で話させる',
duration: 10,
resolution: '2k',
aspect_ratio: '16:9',
images: [
'https://example.com/explorer-reference.jpg',
'https://example.com/environment-reference.jpg'
],
videos: ['https://example.com/camera-movement-reference.mp4'],
audios: ['https://example.com/voice-reference.mp3']
}
レスポンス形式
初期レスポンス
すべてのモデルは、ポーリング用の task_id を返します。
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "submitted"
}
}
ポーリングレスポンス
GET /api/v1/video/{taskId} をポーリングしてステータスを確認します。
{
"code": 0,
"message": "success",
"data": {
"task_id": "{task_id}",
"response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
"task_status": "succeed",
"task_status_msg": null,
"task_result": {
"videos": [
{
"url": "https://example.com/generated-video.mp4"
}
]
}
}
}
ステータス値
submitted：タスクが受け付けられ、処理を待機中processing：動画生成を処理中succeed：動画生成が完了failed：動画生成に失敗
ベストプラクティス
- 動きを明確に記述する：プロンプトに具体的な動きの説明を含めます
- 解像度の選択：高速な処理には
768p、高品質な出力には 2k を使用します
- 画像品質：画像から動画を生成する場合は、最良の結果を得るために高品質な入力画像を使用します
- 参照素材の順序：
images、videos、audios を意図した順序に保ち、プロンプト内で一貫して参照します
- @（AT）参照：どの参照素材でシーンの各部分を生成するかを明示的に制御する必要がある場合は、
<<<image_N>>>、<<<video_N>>>、<<<audio_N>>> プレースホルダーを使用します