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 半額は含みません

他のモデルと比較
出力仕様チャネルチャネルの公開価格所要時間試す
1K
MiniMax公式
試す
KIE
所要時間 15 秒
15 秒試す
2K
MiniMax公式
所要時間 27 秒
27 秒試す
KIE
所要時間 26 秒
26 秒試す
4K
MiniMax公式
試す
KIE
所要時間 37 秒
37 秒試す

自動ルーティングとフェイルオーバー

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

API を使う

コーディングエージェントにコードを任せる、MCP や Skill で会話の中で生成する、または SDK・OpenAI 互換 API で自分で組み込めます。

コーディングエージェントに組み込ませる

組み込み用プロンプトをコピーするか、Codex や Claude で直接開いてください。エージェントがこのページとモデル仕様を読み、送信・待機・結果処理をプロジェクトに書き込みます。

Yir MCP サーバーを追加

ChatGPT、Claude、Cursor に接続し、会話で @Yir と MiniMax H3 Image を指名します。先に料金を提示し、確認してから生成します。

https://gateway.yir.ai/mcp
クライアント別の手順

Claude 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
Yir Skill について

パッケージマネージャーで公式 SDK をインストールするか、下のコードスニペットをコピーして始めましょう

$pnpm add @yir-ai/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"
  }'

パラメータの概要

よく使うパラメータです。上限は現在のモデルと選択したチャネルによって異なります

API ドキュメント
解像度
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

入力方式ごとの参照上限は選択したチャネルによって異なります。料金表の枚数は計算例であり、入力上限や無料枠ではありません。

よくある質問

MiniMax H3 Image で開発を始める

同じ仕様をチャネル間で比較し、1 つのウォレットで複数のチャネルを呼び出せます。