MiniMax H3 Image API
MiniMax のオープンウェイト画像モデル。最大約 1700 万画素のネイティブ 4K と、参照画像 16 枚までの編集に対応
- 1K
- KIE $0.0115 / 枚
- 公式
≈$0.031263%–72% 安い - 2K
- KIE $0.0115 / 枚
- 公式
≈$0.032865%–72% 安い - 4K
- KIE $0.03 / 枚
- 公式
≈$0.078262%–69% 安い
MiniMax H3 Image API の 1 枚あたり料金
KIE は解像度ごとの定額で MiniMax 定価の約 4 割、参照画像 1 枚ごとに $0.0025 加算。公式価格はトークン単位の見積もりで、MiniMax のリリース週の 4K 半額は含みません
自動ルーティングとフェイルオーバー
1 つのモデル ID で MiniMax H3 Image を呼ぶと、Yir がジョブごとに MiniMax、KIE からチャネルを選びます。条件を満たすチャネルのうち推定価格が最も低いものに送り、そのチャネルの公開価格のまま上乗せなしで請求します。試行が失敗と確認されると、max_cost の範囲内で別のチャネルに切り替えて再試行します。リクエストにルーティングパラメータは不要です。 ルーティングとフェイルオーバーのドキュメント
料金の注記
実際にジョブを実行したチャネルの価格で請求されます。フェイルオーバーでチャネルが切り替わると、コストや所要時間が変わる場合があります。
ネイティブ 4K、重みも公開
16 GB の GPU 1 枚で動くオープンウェイト
重みは Hugging Face で公開。16 GB の RTX 5080 1 枚で 1600 万画素の画像を生成した例があり、不足分はメインメモリから読み込み
文字とデザインが最高点
第三者が 1600 万画素で 600 プロンプトを試し、AI 採点の平均は 5 点中 3.94
- 文字とデザイン
- 4.36
- 人物
- 4.22
- 商用
- 3.56
- 情報デザイン
- 3.56
生成サンプル
ここにある画像はすべて MiniMax H3 Image で生成したものです。開くと元のプロンプトを Playground で試せます
100% で切り抜いても破綻しない
各タイルは上の 4K 原画像を 1:1 ピクセルで切り抜いたもので、全体の約 7%

手書きのスパイスラベル

網を繕う節くれだった手

クモの巣に並ぶ露

はしごの上で本を取る人
API を使う
コーディングエージェントにコードを任せる、MCP や Skill で会話の中で生成する、または SDK・OpenAI 互換 API で自分で組み込めます。
コーディングエージェントに組み込ませる
組み込み用プロンプトをコピーするか、Codex や Claude で直接開いてください。エージェントがこのページとモデル仕様を読み、送信・待機・結果処理をプロジェクトに書き込みます。
Yir MCP サーバーを追加
ChatGPT、Claude、Cursor に接続し、会話で @Yir と MiniMax H3 Image を指名します。先に料金を提示し、確認してから生成します。
https://gateway.yir.ai/mcpClaude Code はコマンド 1 行
コンソールで API キーを作成して YIR_API_KEY に設定し、次を実行します:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Yir Skill をインストール
エージェントの実行環境に YIR_API_KEY を設定し、Claude Code、Codex などに追加したら、「Yir の MiniMax H3 Image で…を作って」と頼むだけです。
npx skills add yir-ai/skillsパッケージマネージャーで公式 SDK をインストールするか、下のコードスニペットをコピーして始めましょう
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // デフォルトでは環境変数から YIR_API_KEY を読み込みます: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. 画像生成ジョブを送信 |
| const job = await client.submitImage({ |
| model: "minimax/minimax-h3-image", |
| input: { |
| type: "text", |
| prompt: "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル", |
| }, |
| parameters: { |
| resolution: "4K", |
| aspect_ratio: "1:1", |
| n: 1, |
| }, |
| }); |
| // 2. ジョブの完了と結果の納品を待機 |
| const result = await client.waitForJob(job.id); |
| console.log("納品ファイル:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
OpenAI プロトコルを使っているプロジェクトや new-api などのゲートウェイなら、Base URL とキーを変えるだけです。 OpenAI 互換ガイド
- OpenAI SDK の base_url
https://gateway.yir.ai/openai/v1- new-api のチャネル Base URL
https://gateway.yir.ai/openai- キー
- Yir の API Key
- モデル ID
minimax/minimax-h3-image
curl https://gateway.yir.ai/openai/v1/images/generations \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax/minimax-h3-image",
"prompt": "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル",
"resolution": "4K",
"aspect_ratio": "1:1"
}'パラメータの概要
よく使うパラメータです。上限は現在のモデルと選択したチャネルによって異なります
- 解像度 resolution
- 1K
- 2K
- 4K
出力解像度の段階です。高解像度ほど精細になり、価格もそれに応じて上がります
- アスペクト比 aspect_ratio
- 1:1
- 2:3
- 3:2
- 3:4
- 4:3
- 4:5
- 5:4
- 9:16
- 16:9
- 21:9
画面の縦横比です。用途(縦長、バナー、正方形)に合わせて選んでください
- 入力モード input_mode
- テキスト入力
- 画像入力
参照の上限と形式はモデルと選択したチャネルによって異なります
- 参照素材 references
- reference_image ≤ 16
入力方式ごとの参照上限は選択したチャネルによって異なります。料金表の枚数は計算例であり、入力上限や無料枠ではありません。





