APIMaster.ai

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"
}