MiniMax H3 Image API — text-to-image and editing with up to 16 reference images, 1K to 4K
minimax-h3-imageMiniMax H3 Image は MiniMax の画像生成モデルです。apimodels.app では API キー 1 つで minimax-h3-image として呼び出せます(MiniMax 表記の MiniMax-H3-Image も使えます)。1 つのモデルでテキストからの生成と画像編集の両方に対応し、プロンプトだけを送ればテキストから生成、1〜16 枚の参照画像を加えれば、写真の一部の変更、スタイルの変更、複数画像の合成ができます。参照画像はプロンプト内で「画像1」「画像2」のように指せます。1 回のリクエストで 1〜10 枚を出力します。サイズの指定方法は 2 通りで、面積の段階 1K・2K・4K(既定は 2K)に auto または 1:3〜3:1 の任意の比率を組み合わせるか、655,360〜20,000,000 ピクセルの範囲で正確なサイズを指定します。出力は既定で JPEG、指定すれば PNG や WebP も選べます。テキストからの生成ではモデルのプロンプト拡張が既定で働き、disable_prompt_enhanced で無効にできます。編集時は常に有効です。私たちのテストでは、1K・16:9 のテキストからの生成が約 10 秒で 1360×768 を返し、参照画像 1 枚での 1K 編集は約 16 秒でした。料金は 1K・2K が 1 枚 $0.03、4K が $0.10(約 500 万画素を超えるカスタムサイズは 4K 扱い)で、参照画像 1 枚ごとに $0.01 が加わります。課金は実際に届いた画像の分だけで、失敗したリクエストは無料です。約 240 万画素を超える参照画像は、送信前に縦横比を保って縮小されます。すべてのリクエストが成功するわけではなく、コンテンツ審査でプロンプトや画像が拒否されることがあります。マスク、透過背景、negative_prompt、seed には対応しておらず、黙って無視せずに 400 を返します。より速く出力したい場合は、料金は上がりますが minimax-h3-image-highspeed を使ってください。
Generate Image
Result
Generated image will appear here
Enter a prompt and click Generate
1 つのモデルで生成も編集も
プロンプトだけならテキストから生成。1–16 枚の参照画像を足せば(プロンプトでは image 1、image 2… と呼ぶ)、写真の一部の修正、スタイル変更、複数画像の合成ができます
1K・2K・4K、比率は 1:3〜3:1
面積の段階(既定は 2K)に auto か任意の X:Y を組み合わせるか、655,360〜20,000,000 ピクセルの正確なサイズを指定。出力は JPEG、PNG、WebP
1 回で 1–10 枚
n は最大 10 で、まとめて 1 つのレスポンスで返ります。課金は実際に届いた画像の分だけ
1 枚 $0.03 / $0.10
1K・2K は $0.03、4K は $0.10(約 5 MP を超える独自サイズは 4K 扱い)、参照画像 1 枚ごとに $0.01
制限
マスク、透過背景、ネガティブプロンプト、seed には非対応で、黙って無視せず 400 を返します。参照画像は最大 16 枚、各辺 128–8192 px、縦横比は 4:1 まで。約 2.4 MP を超える参照画像は縮小してから送信します
成功率 100% ではないが、失敗は無料
すべてのリクエストが成功するわけではなく、コンテンツ審査でプロンプトや画像が拒否されることがあります。失敗したリクエストは理由を返し、料金はかかりません
MiniMax H3 Image API: text-to-image and editing with up to 16 reference images, 1K to 4K
MiniMax H3 Image is MiniMax's image generation model. Send a prompt and get 1 to 10 images, or add up to 16 reference images to change part of a photo, restyle it or combine several pictures into one. Sizes run from 1K to 4K in any shape from 1:3 to 3:1.
On APIMODELS it is one model id, minimax-h3-image, on POST /v1/images/generations: $0.03 per image at 1K or 2K, $0.10 at 4K, plus $0.01 per reference image. It has no masks, no transparent background and no seed, and not every request succeeds; the limits are listed below.
- Model ID
minimax-h3-image- Input
- Text prompt, plus up to 16 reference images (optional)
- Output
- 1–10 images, 1K / 2K / 4K (default 2K)
- Aspect ratio
- auto or any ratio from 1:3 to 3:1
- Price
- $0.03 (1K / 2K), $0.10 (4K), +$0.01 per reference
MiniMax H3 Image API limits at a glance
What the model accepts and what it does not. Unsupported inputs return a 400 before anything is generated, instead of being silently ignored, so you never pay for an image that skipped part of your request.
| Supported | Not supported | |
|---|---|---|
| Input | A text prompt of up to 32,000 characters, alone or with 1 to 16 reference images for editing, restyling or combining pictures (image 1, image 2… in the prompt) | Masks (inpainting) |
| Reference images | 1 to 16 (+$0.01 each), as public URLs or base64 data URIs; each 128–8192 px per side, the long side at most 4× the short side, up to 64 MB. Anything above about 2.4 MP is scaled down before it is sent | More than 16; images outside those sizes (400) |
| Images per request | 1 to 10 (n); only images actually delivered are charged | n above 10 (400) |
| Size | resolution 1K, 2K or 4K (2K by default) with aspect_ratio auto or any X:Y from 1:3 to 3:1; or an exact size WIDTHxHEIGHT between 655,360 and 20,000,000 pixels | Shapes beyond 1:3 or 3:1; exact sizes outside that pixel range (400) |
| Output format | JPEG by default; PNG or WebP with output_format | Transparent background (background: transparent returns 400) |
| Prompt enhancement | On by default. For text-to-image, disable_prompt_enhanced: true turns it off when you also set aspect_ratio or size | Turning it off for edits (edits always use it) |
| Other controls | aigc_watermark (true / false) | negative_prompt and seed (400; results are not repeatable) |
Not every MiniMax H3 Image request succeeds
Like every image model, it does not succeed 100% of the time. You are charged only for images that are delivered.
A request can fail after it is accepted: content review can refuse the prompt or a reference image, and a generation can hit a temporary error. A failed request returns the reason and costs nothing. When you ask for several images and only some come back, you pay only for those.
Our five test requests on 11 November 2026 all returned images, which is far too few to promise a success rate, so we do not publish one. At 1K they took 6 to 16 seconds; 4K, several images per request and many reference images take longer, so give the call a generous timeout. Build in retries for temporary errors and rewrite refused prompts.
MiniMax H3 Image API pricing
Per output image by size tier, plus a fixed amount per reference image. The text prompt is free.
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| Each output image · 1K or 2K | $0.03 | $0.05 |
| Each output image · 4K | $0.10 | $0.18 |
| Each reference image | +$0.01 | +$0.015 |
| Exact size (size WIDTHxHEIGHT) | Up to 5,033,165 pixels at the 1K / 2K price, above that at the 4K price | Same rule |
2K text-to-image, 1 image
$0.03
1 × $0.03
2K edit with 2 reference images, 1 image
$0.05
$0.03 + 2 × $0.01
4 variations at 2K in one request
$0.12
4 × $0.03; if only 3 come back, $0.09
4K poster, 1 image
$0.10
1 × $0.10
Standard or Highspeed?
Both tiers take exactly the same request: the same fields, the same limits and the same responses. Only the model id, the speed and the price differ, so you can switch with one string.
| minimax-h3-image | minimax-h3-image-highspeed | |
|---|---|---|
| Our 1K 16:9 test (one request each) | Text-to-image about 10 s; edit with one reference about 16 s | Poster with two text lines about 6 s |
| 1K / 2K · 4K · each reference | $0.03 · $0.10 · +$0.01 | $0.05 · $0.18 · +$0.015 |
| Use it for | Batch jobs and pipelines where nobody is waiting on the picture | Interactive apps where a user is waiting for the result |
When MiniMax H3 Image is a good fit, and when it is not
Edits that pull from many pictures
Up to 16 reference images in one request: a product, a model, a background and a style board, referred to as image 1, image 2 and so on.
Several variations at once
n up to 10 in one call, and only the images that come back are charged.
Large sizes and wide shapes
4K, or an exact size up to 20 megapixels, in any shape from 1:3 to 3:1.
Masked inpainting
There are no masks. Describe the change in the prompt and pass the picture as a reference image instead.
Transparent assets
No transparent background. For PNGs with a real alpha channel, use doubao-seedream-5-5 with background: "transparent".
Repeatable results
There is no seed, so the same request returns a different picture each time.
Call it in one request
POST /v1/images/generations with your apimodels.app API key. By default you get a taskId back and poll GET /v1/images/generations?task_id= (or pass a callback_url); with a WIDTHxHEIGHT size or the OpenAI SDK, the images come back in the same response. Full field list in the docs.
curl -X POST https://api.apimodels.app/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "Replace the croissant on the plate with a slice of strawberry cheesecake. Keep the cup, saucer, latte art, steam, table, window light and everything else exactly the same.",
"image": "https://example.com/cafe.jpg",
"resolution": "2K",
"aspect_ratio": "16:9"
}'
# → { "code": 200, "data": { "taskId": "...", "state": "pending", "model": "minimax-h3-image" } }MiniMax H3 Image について
MiniMax H3 Image は MiniMax の画像生成 API です。MiniMax H3 Image は MiniMax の画像生成モデルです。apimodels.app では API キー 1 つで minimax-h3-image として呼び出せます(MiniMax 表記の MiniMax-H3-Image も使えます)。1 つのモデルでテキストからの生成と画像編集の両方に対応し、プロンプトだけを送ればテキストから生成、1〜16 枚の参照画像を加えれば、写真の一部の変更、スタイルの変更、複数画像の合成ができます。参照画像はプロンプト内で「画像1」「画像2」のように指せます。1 回のリクエストで 1〜10 枚を出力します。サイズの指定方法は 2 通りで、面積の段階 1K・2K・4K(既定は 2K)に auto または 1:3〜3:1 の任意の比率を組み合わせるか、655,360〜20,000,000 ピクセルの範囲で正確なサイズを指定します。出力は既定で JPEG、指定すれば PNG や WebP も選べます。テキストからの生成ではモデルのプロンプト拡張が既定で働き、disable_prompt_enhanced で無効にできます。編集時は常に有効です。私たちのテストでは、1K・16:9 のテキストからの生成が約 10 秒で 1360×768 を返し、参照画像 1 枚での 1K 編集は約 16 秒でした。料金は 1K・2K が 1 枚 $0.03、4K が $0.10(約 500 万画素を超えるカスタムサイズは 4K 扱い)で、参照画像 1 枚ごとに $0.01 が加わります。課金は実際に届いた画像の分だけで、失敗したリクエストは無料です。約 240 万画素を超える参照画像は、送信前に縦横比を保って縮小されます。すべてのリクエストが成功するわけではなく、コンテンツ審査でプロンプトや画像が拒否されることがあります。マスク、透過背景、negative_prompt、seed には対応しておらず、黙って無視せずに 400 を返します。より速く出力したい場合は、料金は上がりますが minimax-h3-image-highspeed を使ってください。 APIMODELS のプラットフォーム経由なら、統一 API と明朗な従量課金でこのモデルを呼び出せます。 現在の料金: 1K: $0.03, 2K: $0.03, 4K: $0.1, Each reference image: +$0.01。
主な機能
- 1 つのモデルで生成も編集も -- プロンプトだけならテキストから生成。1–16 枚の参照画像を足せば(プロンプトでは image 1、image 2… と呼ぶ)、写真の一部の修正、スタイル変更、複数画像の合成ができます
- 1K・2K・4K、比率は 1:3〜3:1 -- 面積の段階(既定は 2K)に auto か任意の X:Y を組み合わせるか、655,360〜20,000,000 ピクセルの正確なサイズを指定。出力は JPEG、PNG、WebP
- 1 回で 1–10 枚 -- n は最大 10 で、まとめて 1 つのレスポンスで返ります。課金は実際に届いた画像の分だけ
- 1 枚 $0.03 / $0.10 -- 1K・2K は $0.03、4K は $0.10(約 5 MP を超える独自サイズは 4K 扱い)、参照画像 1 枚ごとに $0.01
- 制限 -- マスク、透過背景、ネガティブプロンプト、seed には非対応で、黙って無視せず 400 を返します。参照画像は最大 16 枚、各辺 128–8192 px、縦横比は 4:1 まで。約 2.4 MP を超える参照画像は縮小してから送信します
- 成功率 100% ではないが、失敗は無料 -- すべてのリクエストが成功するわけではなく、コンテンツ審査でプロンプトや画像が拒否されることがあります。失敗したリクエストは理由を返し、料金はかかりません
Examples by scenario
ユースケース
EC の商品画像
ネットショップ、広告、販促物に使える高品質な商品ビジュアルを生成します。
SNS 向けクリエイティブ
目に留まるビジュアルを用意して、エンゲージメントとブランド認知を伸ばします。
ゲームアセットの生成
キャラクター、背景、小物のコンセプトアートを起こし、ゲーム開発の立ち上がりを速めます。
販促クリエイティブ
ポスター、バナー、キャンペーン素材を従来のデザイン費のごく一部で用意できます。
APIMODELS を選ぶ理由
- 統一 API -- キー 1 本ですべてのモデルへ。プラットフォームごとに登録する必要はありません
- 明朗な料金 -- 従量課金で、1 回あたりの単価は各モデルページに掲載。個人開発者とスタートアップに向いています
- すぐ使える -- 登録した直後から利用でき、支払いはカード・PayPal・Alipay・USDT に対応
- 充実したドキュメント -- cURL / Python / Node.js のサンプル付きで API を詳しく解説
よくある質問
APIMODELS と MiniMax 公式 API の違いは？
APIMODELS は同じ MiniMax H3 Image を集約プラットフォーム経由で提供します。統一された API インターフェースなので、プロバイダごとにアカウントを作る必要はありません。キー 1 本ですべてのモデルに届きます。
How do I call the MiniMax H3 Image API?
Get an API key on apimodels.app and POST to /v1/images/generations with model set to minimax-h3-image (MiniMax's spelling, MiniMax-H3-Image, also works). Send no image for text-to-image, or 1 to 16 reference images (image or images, as URLs or base64) to edit or combine pictures, referring to them in the prompt as image 1, image 2 and so on. By default the call is asynchronous: it returns a taskId that you poll with GET /v1/images/generations?task_id=, or you pass a callback_url. With a WIDTHxHEIGHT size or the OpenAI SDK, the image comes back in the same response. No separate MiniMax account is needed.
How much does the MiniMax H3 Image API cost?
$0.03 per output image at 1K or 2K and $0.10 at 4K, plus $0.01 per reference image; the text prompt is free. A 2K edit with two reference images and one output costs $0.05; four 2K text-to-image outputs in one request cost $0.12. Custom sizes are priced by area: up to about 5.03 megapixels at the 2K price, above that at the 4K price. Only images actually delivered are charged, and a request that fails costs nothing.
Standard or Highspeed (minimax-h3-image-highspeed)?
Both take the same request, fields and limits; they differ in speed and price. We ran one 1K test of each: Highspeed returned a poster in about 6 seconds, the standard model a text-to-image request in about 10 seconds. Highspeed is $0.05 per image at 1K / 2K, $0.18 at 4K and $0.015 per reference image, against $0.03 / $0.10 / $0.01 for the standard model. Use the standard model for batch work that is not waiting on latency, and Highspeed when a user is waiting for the picture.
What are the limits of MiniMax H3 Image?
Prompts up to 32,000 characters; 1 to 10 images per request; up to 16 reference images, each 128 to 8192 pixels per side, the long side at most 4 times the short side and no larger than 64 MB, with anything above about 2.4 megapixels scaled down before it is sent; aspect ratios from 1:3 to 3:1; custom sizes between 655,360 and 20,000,000 pixels. Masks, transparent backgrounds, negative prompts and seeds are not supported and return a 400. Turning off prompt enhancement (disable_prompt_enhanced) works only for text-to-image and needs an aspect ratio or size alongside it.
What size do I get if I do not set one?
A 2K-area image, with the aspect ratio chosen by the model from the prompt (auto). For 1K or 4K pass resolution: "1K" or "4K"; for a fixed shape pass aspect_ratio, for example "16:9"; for exact pixels pass size, for example "2720x1536", in which case resolution and aspect_ratio no longer apply. In our test a 1K 16:9 request returned 1360×768.
What happens when a request fails?
Not every request succeeds: content review can refuse a prompt or an image, and the upstream service occasionally has temporary errors. When you ask for several images, you pay only for the ones delivered; if the whole request fails, nothing is charged and the reserved credit is returned. The response says why it failed: for a review refusal change the prompt or image, for a temporary error simply retry.
MiniMax H3 Image は「画像生成」カテゴリの他のモデルと比べてどうですか？
APIMODELS では MiniMax H3 Image が 60 以上のモデルと同じ API キー・同じ残高の上に並んでいるので、選択は「相性」の問題であって「囲い込み」の問題ではありません。Text to Image、Image Editing · up to 16 Refs、1K / 2K / 4K、Ratios 1:3 to 3:1、1–10 Images per Request、$0.03–$0.10/image に対応しており、「画像生成」カテゴリの他のモデルと価格・機能を並べて評価できます。乗り換えはモデル名の文字列を 1 つ書き換えるだけ。新しいアカウントも追加の実装も要りません。このカテゴリの選択肢と最新価格は apimodels.app/models で確認できます。
MiniMax H3 Image で何ができますか？
MiniMax H3 Image は次に対応しています: Text to Image、Image Editing · up to 16 Refs、1K / 2K / 4K、Ratios 1:3 to 3:1、1–10 Images per Request、$0.03–$0.10/image。パラメータの全一覧と呼び出し例は APIMODELS のドキュメントをご覧ください。
MiniMax H3 Image の API は日本からでも使えますか？
使えます。APIMODELS は国による利用制限を設けておらず、サイトも API もどこからでも利用できます。MiniMax H3 Image は APIMODELS のキー 1 本で呼び出せるので、モデル提供元のアカウントを別に作る必要はありません。
日本円で払えますか？支払い方法は？
残高と料金は米ドル建てです。支払いはクレジットカード(Visa、Mastercard など。Stripe 経由)、PayPal、Alipay、USDT(TRON の TRC20、BNB Smart Chain の BEP20)に対応しています。円建てのカードや PayPal で払う場合、円への換算はカード会社や PayPal 側で行われます。カード、PayPal、Alipay は支払い後すぐ残高に反映され、USDT はブロックチェーン上で送金が確認されてから反映されます。自動チャージも設定でき、$50 のチャージで $1、$100 で $3 のボーナスが付きます。月額料金はなく、使った分だけの従量課金です。