# MiniMax H3 Image

> MiniMax のオープンウェイト画像モデル。最大約 1700 万画素のネイティブ 4K と、参照画像 16 枚までの編集に対応

- モデルページ: https://yir.ai/ja/models/minimax-h3-image
- モデル ID: `minimax/minimax-h3-image`
- 課金：ジョブを実行したチャネルの価格で請求。上流が課金しなかった試行は無料です。

## ネイティブ 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

## 価格

同じ出力仕様での現在のチャネル別公開価格です。公式価格は参考値です。請求は実際にジョブを実行したチャネルに基づき、フェイルオーバー時には変わる場合があります。

| 出力仕様 | チャネル | 公開価格 |
|---|---|---|
| 1K | MiniMax (公式) (テキスト入力) | ≈$0.0218 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0312 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0406 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0501 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0595 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0689 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0783 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0877 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.0972 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1066 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.116 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1254 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1348 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1443 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1537 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1631 / 枚 |
| 1K | MiniMax (公式) (画像入力) | ≈$0.1725 / 枚 |
| 1K | KIE | $0.009 ~ $0.0115 / 枚 |
| 2K | MiniMax (公式) (テキスト入力) | ≈$0.0233 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0328 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0422 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0516 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.061 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0704 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0799 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0893 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.0987 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1081 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1175 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.127 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1364 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1458 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1552 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1646 / 枚 |
| 2K | MiniMax (公式) (画像入力) | ≈$0.1741 / 枚 |
| 2K | KIE | $0.009 ~ $0.0115 / 枚 |
| 4K | MiniMax (公式) (テキスト入力) | ≈$0.0688 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.0782 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.0876 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.0971 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1065 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1159 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1253 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1347 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1442 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1536 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.163 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1724 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1818 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.1913 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.2007 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.2101 / 枚 |
| 4K | MiniMax (公式) (画像入力) | ≈$0.2195 / 枚 |
| 4K | KIE | $0.0275 ~ $0.03 / 枚 |

## パラメータ

- 操作: `generate_image`

| パラメータ | 値 | デフォルト |
|---|---|---|
| `input` | text / image | text |
| `resolution` | 1K / 2K / 4K | 4K |
| `aspect_ratio` | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 | 1:1 |

## 組み込み

どちらかを選んでください。新しいコードには公式 SDK、OpenAI プロトコルを使っている既存プロジェクトには Base URL の差し替えがおすすめです。

### 公式 SDK（TypeScript）

SDK は Standard API（https://gateway.yir.ai）を呼び出してジョブの送信、待機、取得を行います。Go SDK もあります。 https://yir.ai/docs/integrations/sdk

```bash
pnpm add @yir-ai/sdk
```

```ts
import { createNodeYirClient } from "@yir-ai/sdk/server";

// Reads YIR_API_KEY from the environment by default: process.env.YIR_API_KEY
const client = createNodeYirClient();

// 1. Submit an image generation job
const job = await client.submitImage({
  model: "minimax/minimax-h3-image",
  input: {
    type: "text",
    prompt: "柑橘系スパークリングウォーターの商品ポスターを作成。透明なガラス瓶と新鮮なオレンジ、クリーム色の背景、柔らかな自然光、くっきりした商品ラベル",
  },
  parameters: {
    resolution: "4K",
    aspect_ratio: "1:1",
    n: 1,
  },
});

// 2. Wait for the job to finish and deliver its result
const result = await client.waitForJob(job.id);
console.log("Delivered files:", result.result);
if (result.result && "files" in result.result) {
  for (const file of result.result.files) {
    console.log("->", file.url);
  }
}
```

### OpenAI 互換 API

OpenAI SDK や new-api などのゲートウェイ向けの OpenAI Images と Sora Videos プロトコルです。チャットには対応していません。 https://yir.ai/docs/integrations/openai-compatibility

- OpenAI SDK の base_url: `https://gateway.yir.ai/openai/v1`
- new-api のチャネル Base URL（チャネルタイプ OpenAI）: `https://gateway.yir.ai/openai`
- モデル ID: `minimax/minimax-h3-image`

```bash
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"
  }'
```

## FAQ

### MiniMax H3 Image に公式 API はありますか？

はい。MiniMax は自社の公式 API で MiniMax H3 Image を提供しており、上の表ではその価格を公式の参考価格として掲載しています。Yir なら 1 つの API キーで MiniMax H3 Image を呼び出し、各チャネルの公開価格と比較できます。

### MiniMax H3 Image と Nano Banana 2.1、どちらを使うべき？

将来オープンウェイトを自前でデプロイやファインチューニングしたいなら MiniMax H3 Image。価格優先なら Nano Banana 2.1：Yir での 4K 最安チャネルは H3 Image より安く、フェイルオーバー先のプロバイダーも多めです。

### MiniMax H3 Image の 4K は何ピクセル？

約 1600 万〜1700 万画素です。KIE の 4K は 1:1 で 4096 × 4096、16:9 で 5472 × 3072、21:9 で 6272 × 2688。公式ルートは 16:9 で最大 5440 × 3072 です。

### MiniMax H3 Image の 4K 生成はどれくらい速い？

MiniMax は自社プラットフォームで 4K を 10 秒未満と説明しています。KIE で 4K テキストから画像を 6 回試したところ、処理時間は 23〜39 秒、中央値は約 28 秒でした（2026 年 11 月）。

### MiniMax H3 Image は画像に文字を入れられる？

はい。このページのトレイルマップでは、タイトル、地名、凡例がすべて指定どおりに出ました。ただし指定していない「EST. 1925」の 1 行が加わりました。文字は引用符で囲み、位置も書いてください。

### MiniMax H3 Image はオープンソース？

重みは Hugging Face（MiniMaxAI/MiniMax-H3-Image）で公開されており、将来は自前でのデプロイやファインチューニングも可能です。Yir 経由なら MiniMax 公式 API か KIE を呼ぶだけで、デプロイは不要です。

## ルール

- Authorization: Bearer $YIR_API_KEY で認証します。キーはサーバーの環境変数に置き、ブラウザのコード、ソース管理、プロンプト、ログには含めないでください。
- ジョブは非同期です。Job ID を保持し、終了状態まで待ってから結果を読み取り、失敗とキャンセルも処理してください。
- 安全にリトライするには、同じ冪等キーと同じリクエストを再利用してください。結果が不明なときにむやみに再送信しないでください。
- 結果の URL は一時的なものです。保存が必要な場合はファイルを別の場所にコピーしてください。

## リンク

- [クイックスタート](https://yir.ai/docs/getting-started/quickstart)
- [API リファレンス](https://yir.ai/docs/reference)
- [llms.txt](https://yir.ai/llms.txt)