MiniMax H3 動画生成 API の使い方(768P と 2K、ネイティブステレオ音声)

RelayDance で MiniMax H3 の動画を生成するには、https://relaydance.com/v1/video/generations に POST し、model に minimax-h3-768p または minimax-h3-2k を指定して、プロンプト、4 秒から 15 秒の長さ、アスペクト比を渡します。あとは GET /v1/video/generations/{task_id} をポーリングし、ステータスが succeeded になったら動画 url を取得するだけです。すべてのクリップに追加料金なしでネイティブステレオ音声が付属し、768P は毎秒 $0.10 です(relaydance.com/models 参照)。

MiniMax H3 を選ぶ理由

MiniMax H3 の最大の特徴は音と映像が同源であることです。音声トラックは映像と同じ生成プロセスで作られるため、足音、環境音、セリフが自然に映像と同期します。768P は実測 1344x768、24 fps で出力され、2K は最高画質向けです。課金は生成された秒数に厳密に比例するので、6 秒のクリップには 6 秒分の料金しかかかりません。同じエンドポイント、同じ API キーで Seedance と使い分けられます。

ベース URL の設定と認証

OpenAI 互換クライアントのベース URL を https://relaydance.com/v1 に変更し、Authorization: Bearer YOUR_API_KEY を付けてリクエストします。API キーはコンソール(relaydance.com/console)で作成できます。MiniMax のアカウント、法人契約、KYC は不要です。従量課金で、クレジットカード(Stripe)と USDT に対応しています。リクエストの完全な仕様は relaydance.com/docs を参照してください。

テキストから動画: 最初のリクエスト

最小構成はモデル、プロンプト、長さ、アスペクト比です。テキストからの生成では ratio(16:9、9:16、1:1)が必須で、省略時は RelayDance が 16:9 を補います。adaptive は参照画像を添付した場合のみ有効です。

curl -X POST https://relaydance.com/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-768p",
    "prompt": "夕暮れの海で小さな波に乗るコーギー、シネマティック、穏やかな波の音、遠くにカモメの鳴き声",
    "duration": 6,
    "ratio": "16:9"
  }'

レスポンスに task_id が含まれます。duration は 4 から 15 の整数で、OpenAI 形式の文字列フィールド seconds も受け付けます。

画像から動画と参照画像

同じリクエストボディに "image": "https://example.com/photo.jpg" を追加すると、1 枚の参照画像を添付できます。参照画像がある場合は "ratio": "adaptive" が有効になり、元画像の比率に従います。複数の参照画像は metadata.content[] 配列で渡します。各要素は {"type": "image_url", "image_url": {"url": "..."}, "role": "reference_image"} の形です。1 リクエストにつき最初の 5 枚は無料、以降は 1 枚あたり約 $0.05 です。

タスクのポーリングと結果の取得

GET /v1/video/generations/{task_id} を status が succeeded または failed になるまでポーリングします。成功時のレスポンスに動画 url が含まれます。生成は通常数分で完了します(2K は 768P より時間がかかります)。失敗したリクエストは課金されず、事前ホールドされた残高は自動的に全額解放されます。

料金

MiniMax H3 は生成された動画の秒数で課金されます。タスク送信時に RelayDance が最大ケースで事前ホールドし、実際の出力秒数が確定すると差額を自動で返金します。最新料金は relaydance.com/models に掲載されています。

パラメータ早見表

最初の MiniMax H3 動画を作る手順

1. https://relaydance.com/console で API キーを作成します。
2. /v1/video/generations に POST します。model は minimax-h3-768p、prompt、4 から 15 の duration、ratio を指定します。
3. 必要に応じて image で画像から動画に、または metadata.content[] で複数の参照画像を渡します。
4. GET /v1/video/generations/{task_id} を succeeded か failed までポーリングします。
5. 返された url から動画をダウンロードします。ステレオ音声トラックは既に埋め込まれています。

よくある質問

音声トラックは追加料金ですか? いいえ。両ティアともネイティブステレオ音声が生成に含まれ、支払うのは秒単価の動画料金だけです。

クリップの最長は? 4 秒から 15 秒です。最長 30 秒が必要な場合は、同じエンドポイントの Seedance 2.5(doubao-seedance-2-5-720p)を使ってください。

リクエストが失敗したら課金されますか? いいえ。relaydance.com/models の公式ドキュメントのとおり、失敗またはエラーになったリクエストは一切課金されません。

768P と 2K のどちらを選ぶべき? 768P は 1344x768、24 fps で毎秒 $0.10 のコスパ重視。2K は毎秒 $0.1625 の画質重視で、生成に時間がかかります。

MiniMax のアカウントは必要? 不要です。RelayDance のキー 1 つで MiniMax H3、Seedance、カタログの全モデルを呼び出せます。