MiniMax H3 Fast APIドキュメント
コードからMiniMax H3 Fastを呼び出すために必要な情報をすべて掲載しています。ベースURLはhttps://cheapergen.com/api/v1です。まずプレイグラウンドでお試しください。
コーディングエージェントを使いますか?
これをClaude Code、Cursor、Codex、または任意のコーディングエージェントに貼り付けてください。プロジェクトにAPIを追加し、キーをCHEAPERGEN_API_KEYに保存して、支払いが発生する前に無料見積もりでテストします。
Add MiniMax H3 Fast (CheaperGen endpoint minimax/ h3-fast/ text-to-video) to this project by following https:/ / cheapergen.com/ agents/ integrate.md認証
ダッシュボード → APIキーでキーを作成し、Bearerトークンとして送信してください。キーはサーバー側で管理してください。
export CHEAPERGEN_API_KEY="cg_live_…"
# every request
Authorization: Bearer $CHEAPERGEN_API_KEYMiniMax H3 Fast テキストから動画を生成 API
/api/v1/run/minimax/h3-fast/text-to-video非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
aspect_ratio | string (enum) | 出力フレームの形状。 値:16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 デフォルト:16:9 | はい |
resolution | string (enum) | 出力解像度。高解像度では秒単価が上がります。 値:480P · 768P デフォルト:768P | はい |
duration | integer | 生成クリップの長さ(4〜15秒)。秒単位で課金されます。 範囲:4~15s デフォルト:6 | はい |
seed | integer | 同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。 | いいえ |
enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. デフォルト:true | いいえ |
webhook_url | string (URL) | 任意。生成が完了すると、Webhookシークレットで署名してここにPOSTします。Webhook | いいえ |
リクエスト
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/text-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "夕暮れ、雨水で満ちた溝を紙のボートが流れていく。雨音と遠くの路面電車のベル。",
"aspect_ratio": "16:9",
"resolution": "768P",
"duration": 6
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);レスポンス
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/text-to-video",
"mode": "text-to-video",
"status": "queued",
"input": {
"prompt": "夕暮れ、雨水で満ちた溝を紙のボートが流れていく。雨音と遠くの路面電車のベル。",
"aspect_ratio": "16:9",
"resolution": "768P",
"duration": 6
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "reference",
"list_price_label": "Official MiniMax H3 API",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}MiniMax H3 Fast 画像から動画を生成 API
/api/v1/run/minimax/h3-fast/image-to-video非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
image_url必須 | string (URL) | 開始フレームに使う画像。JPG/PNG/WebP、URLまたはアップロード。 | いいえ |
end_image_url | string (URL) | 任意の終了フレーム。モデルが2つのフレームの間を動画にします。 | いいえ |
aspect_ratio | string (enum) | 出力フレームの形状。最初のフレームに近いものを選んでください。 値:16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 デフォルト:16:9 | はい |
resolution | string (enum) | 出力解像度。高解像度では秒単価が上がります。 値:480P · 768P デフォルト:768P | はい |
duration | integer | 生成クリップの長さ(4〜15秒)。秒単位で課金されます。 範囲:4~15s デフォルト:6 | はい |
seed | integer | 同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。 | いいえ |
enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. デフォルト:true | いいえ |
webhook_url | string (URL) | 任意。生成が完了すると、Webhookシークレットで署名してここにPOSTします。Webhook | いいえ |
リクエスト
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "朝の光の中で、花がゆっくり開く。背景には鳥のさえずり。",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "768P",
"duration": 6
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);レスポンス
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/image-to-video",
"mode": "image-to-video",
"status": "queued",
"input": {
"prompt": "朝の光の中で、花がゆっくり開く。背景には鳥のさえずり。",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"aspect_ratio": "16:9",
"resolution": "768P",
"duration": 6
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "reference",
"list_price_label": "Official MiniMax H3 API",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}MiniMax H3 Fast 参照素材から動画を生成 API
/api/v1/run/minimax/h3-fast/reference-to-video非同期ジョブを送信すると、生成IDを含む202が返されます。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定してください。詳細はジョブのライフサイクルをご覧ください。
入力パラメーター
| 名前 | 種類 | 説明 | 料金に影響 |
|---|---|---|---|
prompt必須 | string | ショットを説明してください:被写体、動き、カメラワーク、照明、スタイル。 | いいえ |
reference_image_urls | string[] (URLs) | キャラクター、商品、スタイル、シーン用の画像を最大9枚まで。@Image1、@Image2…と指定できます。最初の5枚は無料です。追加画像ごとに少額の料金がかかります。 最大項目数:9 | いいえ |
reference_video_urls | string[] (video URLs) | 動き、カメラワーク、効果用のクリップは最大3MP4/MOV本です(1本あたり2〜15秒, 合計15秒, 1ファイルあたり50 MB以下)。@Video1、@Video2…とプロンプト内で指定してください。参照動画の秒数は出力秒数と同じ料金です。 最大項目数:3 | はい |
reference_audio_urls | string[] (audio URLs) | 声、音楽、効果音用のクリップは最大3MP3/WAV本まで指定できます(1本あたり2〜15秒, 合計15秒, 1ファイルあたり15 MB以下)。@Audio1、@Audio2…と参照してください 参照画像または動画を1つ以上追加してください。 最大項目数:3 | いいえ |
aspect_ratio | string (enum) | 出力フレームの形状。 値:16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 デフォルト:16:9 | はい |
resolution | string (enum) | 出力解像度。高解像度では秒単価が上がります。 値:480P · 768P デフォルト:768P | はい |
duration | integer | 生成クリップの長さ(4〜15秒)。秒単位で課金されます。 範囲:4~15s デフォルト:6 | はい |
seed | integer | 同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。 | いいえ |
enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. デフォルト:true | いいえ |
webhook_url | string (URL) | 任意。生成が完了すると、Webhookシークレットで署名してここにPOSTします。Webhook | いいえ |
リクエスト
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/reference-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "@Image1の歌手が屋上で歌い、@Video1のカメラワークに合わせます。ボーカルには@Audio1を使用。",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg"
],
"reference_video_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp4"
],
"reference_audio_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp3"
],
"aspect_ratio": "16:9",
"resolution": "768P",
"duration": 6
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);レスポンス
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "minimax/h3-fast",
"endpoint": "minimax/h3-fast/reference-to-video",
"mode": "reference-to-video",
"status": "queued",
"input": {
"prompt": "@Image1の歌手が屋上で歌い、@Video1のカメラワークに合わせます。ボーカルには@Audio1を使用。",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg"
],
"reference_video_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp4"
],
"reference_audio_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp3"
],
"aspect_ratio": "16:9",
"resolution": "768P",
"duration": 6
},
"output": null,
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": true,
"official_usd": null,
"list_price_source": "reference",
"list_price_label": "Official MiniMax H3 API",
"saved_usd": null
},
"source": "api",
"started_at": null,
"completed_at": null,
"urls": {
"get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
"cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
},
"created_at": "2026-10-15T09:21:04Z"
}結果を取得する
生成処理は非同期です。statusがsucceeded、failed、またはcanceledになるまでポーリングしてください。送信時にwebhook_urlを指定する方法もあります。失敗した生成は自動返金されます。
curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY"その他:ジョブのライフサイクル · Webhook · エラー
MiniMax H3 Fastの料金
従量課金: 動画1秒あたりを使った分だけ支払えます。サブスクリプションは不要です。生成に失敗した場合は自動で返金されます。
| プラン | MiniMax公式H3 API | CheaperGen | 節約額 |
|---|---|---|---|
480P 秒単位 · 音声込み · MiniMax H3 Max 480Pと比較 | $0.0369/s 月額プランの場合: Pro $0.0352Max $0.0335 | −26% | |
768P 秒単位 · 音声込み · MiniMax H3 768Pと比較 | $0.0546/s 月額プランの場合: Pro $0.0518Max $0.049 | −32% |
月額プラン多くのモデルが割引価格になります(各モデルの料金の下に表示)。従量課金も引き続き利用できます。Pro $499/月 · Max $4,999/月。
- MiniMax公式H3 API:同じ解像度でのMiniMax公式H3 API価格(platform.minimax.io)。MiniMaxはH3 Fastを販売していないため、比較対象はMiniMax H3 768Pの1秒あたり$0.08と、公式H3の唯一の480PプランであるMiniMax H3 Max 480Pの$0.05です。。価格確認日:2026年10月18日。
- Reference to Videoでは参照動画の秒数を出力と同じ料金で課金します。最初の参照画像5枚は無料で、追加画像ごとに約1秒分の料金がかかります。最初・最後のフレームと参照音声は無料です。
- 高速化版の比較価格には、同じ解像度におけるMiniMax公式H3 APIの料金を表示します(768PはH3、480PはH3 Max)。MiniMaxはH3 Fastの料金を設定していません。