MiniMax-H3 API

ひと目でわかる概要

MiniMax-H3 APIは、POST https://api.mage.space/v1/minimax_h3/generate を通じて、MageでMiniMax-H3 Turboともう1つのバリアントを実行します。デフォルト設定のリクエストは30 Gems(約$0.03)で、サブスクリプションは不要です。MiniMax-H3では、保存済みのキャラクター、参照、音声参照をプロンプト内で @handle を指定して使えます。

• 動画

  出力

• 2

  バリアント

• 30

  1クリップあたりのGems(デフォルト)

• $0.03

  米ドル換算の目安

概要

MiniMax-H3 APIでできること

映像とステレオ音声を同時に生成する、高速なオープン動画モデル。開始・終了フレーム、または最大8件の参照(長いクリップほど件数は少なくなります)に対応し、5〜15秒、最大768pで生成できます。

動画とステレオ音声を同時に生成する、高速なオープン動画モデルです。

入力としてfirst_image、last_image、image、additional_images、videosを受け付けます。

クイックスタート

MiniMax-H3 APIを呼び出す

MAGE_API_KEY を設定して /minimax_h3/generate にリクエストを送り、リクエストが完了するまで status_url をポーリングします。

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "5",
  "model_id": "minimax-h3-turbo"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_h3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'minimax-h3-turbo',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_h3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "minimax-h3-turbo",
})

print(request["result"]["url"])

モデル

MiniMax-H3 の model_id の値

model_idを送信してバリアントを選択します。指定しない場合はデフォルトが実行されます。

オプション

MiniMax-H3 のパラメータ

全バリアントで使用できる値です。バリアントによっては選択肢が少ない場合があります。バリアントごとのオプションはドキュメントに記載されています。

入力

MiniMax-H3 が受け付けるメディア入力

いずれも、httpsのURL、データURL、または最大100 MBのアップロードで送信できます。

ルール

MiniMax-H3 API の制約

• 最初と最後のフレームは、参照画像や参照動画と組み合わせられません。どちらか一方のみ送信してください。
• 参照画像は最大9枚、参照動画は最大3本で、各動画の長さは2〜15秒です。
• 参照はクリップと合わせて21秒の上限を共有します。`duration` に、参照画像・メンションしたキャラクター・メンションした参照1件につき2秒、さらに参照動画1秒につき1.15秒(`duration` を上限として計算)を加えた合計が21以下である必要があります。

その他の動画モデル

Mageのその他の動画生成API

FAQ

よくある質問

Mageで開発を始めよう

アカウントはひとつ、Gemsの残高もひとつで、すべてのモデルが使えます。料金は生成した分だけです。

関連情報

• AI動画生成API
• MiniMax-H3 APIリファレンス
• MiniMax-H3プレイグラウンド
• すべてのAPIモデル
• Mage MCPサーバー