MiniMax-H3 動画生成 API
APIMaster で MiniMax-H3 の非同期動画タスクを作成し、状態を確認して MP4 をダウンロードします。
MiniMax-H3 動画生成
APIMaster の OpenAI 互換動画 API で MiniMax-H3 を利用できます。生成は非同期です。
Base URL:
https://apimaster.ai/v1はhttps://apimaster.ai/v1です。POST https://apimaster.ai/v1/video/generationsで作成します。
エンドポイントの互換性と検証
POST https://apimaster.ai/v1/video/generations と POST https://apimaster.ai/v1/videos/generations の両方に対応しています。同じモデルではパラメータと課金ルールが共通で、作成レスポンスは各エンドポイントの従来形式を維持します。既存クライアントのパス変更は不要です。
MiniMax-H3 の例は単数形を維持し、size と resolution、ratio と aspect_ratio は同義です。非対応の値や矛盾する指定は HTTP 400 を返し、より高い解像度に自動変更しません。解像度・比率・時間を明示してください。
タスクを作成
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
model |
string | はい | MiniMax-H3 |
prompt |
string | 形式による | 動画の説明 |
duration |
integer | いいえ | 4–15 秒、既定値 4 |
size |
string | いいえ | 768P または 2K、既定値 768P |
ratio |
string | いいえ | アスペクト比、既定値 16:9 |
curl -s "https://apimaster.ai/v1/video/generations" \
-H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"MiniMax-H3","prompt":"A calm ocean at sunrise, cinematic wide shot","duration":4,"size":"768P","ratio":"16:9"}'
レスポンスには queued 状態の id と task_id がすぐに返ります。
状態を確認
GET https://apimaster.ai/v1/videos/{task_id} は queued、in_progress、completed、failed を返します。
curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
送信後 10–20 秒待ち、その後 3–5 秒ごとにポーリングしてください。
動画をダウンロード
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o output.mp4
状態が completed になったら MP4 を保存してください。duration は 4–15 秒、size は 768P と 2K に対応します。
参照画像から動画生成(r2v)
上記の APIMaster エンドポイントへ公式 V2 の content 配列を送信します。空でない text 要素が必須です。content があればトップレベルの prompt は不要です。reference_image は被写体やスタイルの参照であり、最初のフレームを固定しません。従来の images は最初の2枚を開始・終了フレームに割り当てます。これらと参照ロールを混在させないでください。
{
"model": "MiniMax-H3",
"content": [
{"type": "text", "text": "Use the character in Image 1 as the subject, walking through a garden."},
{"type": "image_url", "image_url": {"url": "https://YOUR_PUBLIC_IMAGE_URL/reference.jpg"}, "role": "reference_image"}
],
"resolution": "768P",
"duration": 4,
"ratio": "16:9"
}
