ナビゲーションにスキップ
動画 APIMiniMax

MiniMax H3

POST https://api.beatapi.io/v1/videos/tasks

元の MiniMax H3 モデル ID は、Fast の速度区分、料金、リクエスト仕様を維持します。480p・768p・1080p で、低速でも半額の生成を利用したい場合は minimax-h3-normal を指定してください。

対応する生成モード

モード必須の入力入力ルール
テキストから動画を生成model, promptメディアの配列はすべて省略してください。
開始フレームを指定model, prompt, images画像 URL を 1 個指定します。
開始・終了フレームを指定model, prompt, images開始フレーム、終了フレームの順に、画像 URL を 2 個指定します。
画像・動画・音声を参照model, prompt, いずれか 1 つの reference_* 配列images と reference_* の入力は併用しないでください。

従来の Fast の API 仕様では、768P と 2K に対応しています。別モデルの minimax-h3-normal は 480p・768p・1080p に対応し、処理速度は遅くなりますが料金は半額です。

非同期処理の流れ： タスクを作成して data.id を保存し、GET /v1/tasks/{task_id} でステータスをポーリングします。succeeded の場合は data.output.media から結果を取得します。failed の場合は data.error_code と data.error_message を確認し、エラーと再試行の方針に従って対処してください。

ローカルファイルを使う場合： 先に入力ファイルをアップロードし、返された data.url を指定してください。

認証

Authorization   string   必須

BeatAPI の API キーを Bearer トークンとして送信します。API キーはダッシュボードで作成できます。

Authorization: Bearer <BEATAPI_API_KEY>

通常の API キーは、信頼できるサーバーで管理してください。リクエストボディには Content-Type: application/json が必要です。対応するエンドポイントでは Idempotency-Key は任意ですが、同一のリクエストボディで安全に再試行するために指定を推奨します。

リクエストボディ

model   string   必須

minimax-h3 を指定してください。

固定値: minimax-h3

prompt   string   必須

動画生成の指示です。

文字数: 1 – 5000 文字

images   string[]   任意

開始フレーム 1 枚、または開始・終了フレームを公開 HTTPS URL で指定します。開始・終了フレームを使うには、768P または 2K が必要です。

要素数: 1 – 2 件

reference_images   string[]   任意

マルチモーダル生成で参照する、公開 HTTPS 画像 URL です。

要素数: 1 – 9 件

reference_videos   string[]   任意

マルチモーダル生成で参照する、公開 HTTPS 動画 URL です。768P と 2K のみで利用できます。

要素数: 1 – 3 件

reference_audios   string[]   任意

マルチモーダル生成で参照する、公開 HTTPS 音声 URL です。音声を使う場合は、少なくとも 1 つの参照画像または参照動画も必要です。

要素数: 1 – 3 件

duration   integer   任意

出力動画の長さを秒単位で指定します。

デフォルト値: 5
範囲: 4 – 15

aspect_ratio   enum<string>   任意

テキストモードのデフォルト値は 16:9 で、adaptive は指定できません。フレームモードでは 768P と 2K で常に adaptive が使われます。参照モードのデフォルト値は adaptive で、具体的な比率も指定できます。

選択肢: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

resolution   enum<string>   任意

出力解像度の区分です。従来の H3 の Fast の API 仕様では、768P と 2K に対応しています。

選択肢: 768P, 2K
デフォルト値: "768P"

リクエスト例

テキストから動画を生成

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3",
  "prompt": "A slow cinematic push through a misty mountain village at dawn.",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "768P"
}'

開始フレームを指定

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3",
  "prompt": "The performer turns toward the camera as neon light sweeps across the scene.",
  "images": [
    "https://media.beatapi.io/samples/neon-singer.png"
  ],
  "duration": 5,
  "resolution": "768P"
}'

開始・終了フレームを指定

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3",
  "prompt": "Move smoothly from the opening portrait to the final product reveal.",
  "images": [
    "https://media.beatapi.io/samples/neon-singer.png",
    "https://media.beatapi.io/samples/smart-bottle.png"
  ],
  "duration": 5,
  "resolution": "768P"
}'

画像・動画・音声を参照

curl --request POST \
  --url https://api.beatapi.io/v1/videos/tasks \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "minimax-h3",
  "prompt": "Create a cinematic performance using the supplied visual and audio references.",
  "reference_images": [
    "https://media.beatapi.io/samples/neon-singer.png"
  ],
  "reference_audios": [
    "https://media.beatapi.io/samples/neon-singer-preview.mp3"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "768P"
}'

レスポンス

リクエストが成功すると、HTTP 201 が返されます。

{
  "data": {
    "id": "task_8K2qA",
    "object": "task",
    "task_kind": "video",
    "capability_id": "minimax-h3",
    "capability_version": null,
    "media_type": "video",
    "model": "minimax-h3",
    "status": "queued",
    "stage": "queued",
    "created_at": 1782210000,
    "updated_at": 1782210000,
    "completed_at": null,
    "output": null,
    "usage": {
      "credits_reserved": 0.2,
      "credits_charged": 0.2,
      "billable_duration_seconds": 5,
      "credits_settled": 0,
      "credits_refunded": 0
    },
    "request_id": "req_abc123",
    "error_code": null,
    "error_message": null
  }
}

エラー

ステータスコード意味と対処方法
400JSON の形式が不正、またはフィールド・値・組み合わせが未対応です（bad_request。メッセージにフィールド名が記載されます）。入力がコンテンツ審査で拒否された場合は content_policy_violation です。修正せずに再試行しても成功しません。
401API キーが未指定（missing_api_key）、またはキーが不正・期限切れ・無効・上限到達です（invalid_api_key。理由はメッセージに記載されます）。Authorization: Bearer <key> で送信してください。sk- 接頭辞の有無にかかわらず使えます。そのまま再試行しないでください。
402残高不足です（insufficient_credits）。残高がゼロ、またはこのリクエストの料金に足りません。残高をチャージしてから再度送信してください。それまでは再試行しないでください。
403キーまたはアカウントに、この呼び出しの権限がありません（forbidden）。例として、無料クレジットでは利用できないモデル（チャージすると利用可能）、キーの IP 許可リスト外からのリクエスト、キーのグループに含まれないモデルがあります。そのまま再試行しないでください。
409Idempotency-Key が別のリクエストボディで使用済み、または同じキーの最初のリクエストが処理中です（idempotency_conflict）。そのまま再試行しないでください。
429リクエスト数が上限を超えています（無料モデルの制限を含む rate_limit_exceeded）、または同時処理中のタスクが多すぎます（user_concurrency_exceeded）。Retry-After の秒数だけ待ってから再試行できます。同じ値は error.retry_after_seconds にも含まれます。
500予期しない内部エラーです（internal_error）。再試行できます。繰り返し発生する場合は、request_id を控えてサポートに連絡してください。
503リクエストを完了できませんでした（processing_unavailable、processing_timeout、processing_failed、result_transfer_failed）。課金されていません。待機時間を段階的に延ばして再試行できます。待機時間が判明している場合は Retry-After が返されます。BeatAPI は 502 や 504 を返しません。