無料のMiniMax H3 API:音声付きの動画を無料で
MiniMax H3に、Revanaで無料枠が登場しました。自社のGPUでレンダリングするため、クリップは無料です。テキストまたは画像を入力すると、音声付きの5〜15秒の動画が出力されます。ここでは、できること、キューの仕組み、呼び出すコードを紹介します。
MiniMax H3 Freeとは
minimax-h3-free は、MiniMax H3をFastH3 Omniで動かしたものです。FastH3 Omniは蒸留版で、フルスケジュールの代わりに8ステップでレンダリングします。有料のプロバイダーではなく、自社のGPUで動かしているため、無料で提供できます。すべてのクリップには、映像と同時に生成された音声(足音、声、音楽、部屋の音)が付きます。
| モデルID | minimax-h3-free |
|---|---|
| 機能 | テキストから動画、画像から動画(開始画像)、参照画像 |
| 解像度 | 480p、720p、768p(縦向きは768×1344) |
| アスペクト比 | 9:16, 16:9, 1:1 |
| 長さ | 5〜15秒 |
| 音声 | 常に付き、映像と同時に生成 |
| 画像 | 合計4枚まで |
| 料金 | free |
| 同時実行数 | 1アカウントあたり、待機中または実行中が10ジョブ |
有料の minimax-h3 とは別のモデルIDです。有料モデルには何も変更はなく、リクエストごとにどちらを呼び出すかを選べます。
無料キューの仕組み
GPUは一度に1つのクリップしか作れないため、無料のジョブは順番に処理されます:
- ジョブはすぐに受け付けられます。
POST /v1/generationsは、ほかのモデルと同じように202とIDを返し、GPUに空きができるまで、ジョブはqueuedと表示されます。 - 順番はアカウント単位です。多くの人が待っているときは、GPUは順番待ちの次のアカウントから次のジョブを取り出すため、1つのアカウントが一度に大量に送信しても、ほかの人を後回しにしません。
- アカウントあたり同時に10件まで。待機中または実行中の無料ジョブは、最大10件です。11件目は
429 concurrency_limitで拒否されるため、1つ完了してから送り直してください。 - 最大3時間待機します。それを過ぎても待機中のジョブは、
model_busyで失敗し、課金はありません。
ジョブがGPUに到達すると、768pで約12秒に、クリップ1秒あたり10秒を加えた時間でレンダリングされるため、5秒のクリップで約1分です。10秒ごとを目安にポーリングしてください。ジョブが取りうるすべてのステータスはドキュメントで解説しています。
テキストから無料のクリップを生成する
リクエストは、Revanaのほかのすべてのモデルと同じです。設定する max_cost_usd はなく、事前にクレジットを購入する必要もありません。
export REVANA_API_KEY="sr_live_..."
# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-free",
"input": {
"prompt": "A street drummer plays on upturned buckets on a busy corner at night, coins in a hat at his feet, passers-by slowing to watch. The drums echo off the buildings.",
"resolution": "768p",
"aspect_ratio": "9:16",
"duration": 8
}
}'
# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
-H "Authorization: Bearer $REVANA_API_KEY"画像から始める
開始画像を image_url として送信すると、クリップはその画像から始まり、人物、物、背景が保たれます。さらに最大3枚を image_urls として追加し(合計4枚)、プロンプト内では 「Picture 1」「Picture 2」のように指定します。画像はPNG、JPEG、WebP、GIFで、公開httpsリンクとして渡します。ファイルしかない場合は、先に POST /v1/uploads でアップロードしてください。
import os
import time
import requests
API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}
resp = requests.post(f"{API}/generations", headers=HEADERS, json={
"model": "minimax-h3-free",
"input": {
"prompt": "<Picture 1> turns to the camera and smiles, then walks out of frame. Soft cafe chatter.",
"image_url": "https://example.com/portrait.jpg",
"duration": 5,
},
})
resp.raise_for_status()
job = resp.json()
# A free job may wait in the GPU queue before it renders, so poll patiently
while job["status"] in ("queued", "running"):
time.sleep(10)
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
if job["status"] == "succeeded":
print(job["output"]["urls"])
else:
print("Failed:", job["error"])FastH3 Omniでできないことは、422 invalid_input ですぐに拒否されます。1080pや2Kの解像度、21:9のフレーム、5秒未満または15秒を超えるクリップ、audio: false、動画入力、5枚以上の画像です。これらには、有料の minimax-h3 を使用してください。
無料と有料、MiniMax H3はどちらを使う?
アイデアの試作、絵コンテのドラフト、768pで十分なSNS向けクリップには、無料モデルを使います。2K、より広いフレーム、最初と最後のフレーム、より多くの参照画像、またはすぐに開始されるクリップが必要な場合は、有料モデルを使います。
minimax-h3-free | minimax-h3 | |
|---|---|---|
| 料金 | free | 1秒あたり$0.03から |
| エンジン | FastH3 Omni:MiniMax H3を8ステップで、自社のGPUで実行 | フルステップのMiniMax H3、有料ルート |
| 解像度 | 最大768p | 768pと2K |
| アスペクト比 | 9:16, 16:9, 1:1 | 21:9を含む、より多数 |
| 最初と最後のフレーム | no | yes |
| 参照画像 | 最大4枚 | 最大9枚 |
| 待ち時間 | 無料枠のキューで、ほかのすべてのユーザーと一緒に待機 | すぐに開始 |
すべてのラインナップはHailuoとMiniMaxのガイドに、すべての有料モデルの最安価格は最安動画APIのガイドに掲載しています。すべてのモデルはモデルページに、クレジットパックは料金ページにあり、APIキーを取得すればサンプルを実行できます。
よくある質問
MiniMax H3の無料APIは、本当に無料ですか?
はい。minimax-h3-free のジョブは、見積もり、確保、課金のすべてが0で行われるため、クレジットのないアカウントでも使えます。失敗したジョブも無料です。
minimax-h3-free と minimax-h3 の違いは何ですか?
minimax-h3-free は、MiniMax H3を8ステップに蒸留したもの(FastH3 Omni)で、自社のGPUで最大768pでレンダリングします。minimax-h3 は、有料ルートで提供されるMiniMaxのフルモデルで、2K、より多くのアスペクト比、最初と最後のフレームに対応しています。どちらも音声を生成します。
無料のジョブを同時にいくつ実行できますか?
1アカウントあたり、待機中または実行中のものを10件までです。11件目は、自分のジョブが1つ完了するまで、429 concurrency_limit で拒否されます。
無料のクリップは、どのくらいで完成しますか?
レンダリングが始まってから、約12秒に、クリップ1秒あたり10秒を加えた時間がかかるため、5秒のクリップでおよそ1分です。GPUが混雑している場合は、ほかのアカウントと順番に、最大3時間までキューで待機します。
自分の画像を送れますか?
はい。開始画像1枚を image_url として、参照画像を最大4枚まで image_urls として、合計4枚まで、httpsリンクで送信します。プロンプト内では 「Picture 1」「Picture 2」のように指定します。