お知らせ

無料のMiniMax H3 API:音声付きの動画を無料で

MiniMax H3に、Revanaで無料枠が登場しました。自社のGPUでレンダリングするため、クリップは無料です。テキストまたは画像を入力すると、音声付きの5〜15秒の動画が出力されます。ここでは、できること、キューの仕組み、呼び出すコードを紹介します。

MiniMax H3 Freeとは

minimax-h3-free は、MiniMax H3をFastH3 Omniで動かしたものです。FastH3 Omniは蒸留版で、フルスケジュールの代わりに8ステップでレンダリングします。有料のプロバイダーではなく、自社のGPUで動かしているため、無料で提供できます。すべてのクリップには、映像と同時に生成された音声(足音、声、音楽、部屋の音)が付きます。

MiniMax H3 Freeの概要
モデルIDminimax-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 はなく、事前にクレジットを購入する必要もありません。

cURL
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 でアップロードしてください。

Python
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 の比較
minimax-h3-freeminimax-h3
料金free1秒あたり$0.03から
エンジンFastH3 Omni:MiniMax H3を8ステップで、自社のGPUで実行フルステップのMiniMax H3、有料ルート
解像度最大768p768pと2K
アスペクト比9:16, 16:9, 1:121:9を含む、より多数
最初と最後のフレームnoyes
参照画像最大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」のように指定します。

無料のMiniMax H3クリップを作る

サインアップしてAPIキーを作成し、最初の minimax-h3-free リクエストを送信しましょう。クレジットは不要です。もっと使いたくなったら、同じキーですべての有料モデルを実行できます。