> Markdown copy of https://makernice.com/models/minimax-h3-image/ for AI tools. The HTML page is the canonical version. # MiniMax H3-Image — 13 aspect ratios, up to 16 references MiniMax H3-Image on Makernice is MiniMax's image model (model id minimax-h3-image), separate from the MiniMax H3 video models. MiniMax H3-Image text-to-image offers 13 aspect ratios, from 9:21 and 1:2 to 2:1 and 21:9. Resolution is 1k (the default) or 2k. Image-to-image takes up to 16 reference images and follows their framing instead of an aspect ratio. Highlights 1K / 2K · Text to image · Image to image Best for Developers who need unusual formats like 4:5 or 9:21, or edits that combine many reference images. Input Text, up to 16 reference images Output Image ## Pricing Prepaid in US dollars. The hold is converted to a charge when the run completes. If a run fails or times out, the hold is released in full.\* Prices as of November 11, 2026 (price list v14). Note: if a finished output is blocked by output moderation for a policy violation, the run is still charged. You can contact support for a manual review. Cost of your first test $0.04 One 1K or 2K text-to-image image. What your top-up buys [Top up](https://makernice.com/console/wallet/) $15 ≈ 416 test runs $50 ≈ 1388 test runs $100 ≈ 2777 test runs Top-ups are $15–$1,000. No free tier, no subscription. | Model | Mode | Resolution | Our price | Official | You save | | --- | --- | --- | --- | --- | --- | | MiniMax H3-Image · MiniMax | Text to image | 1K | $0.036/img | | | | MiniMax H3-Image · MiniMax | Text to image | 2K | $0.036/img | | | | MiniMax H3-Image · MiniMax | Image to image | 1K | $0.036/img\+ $0.0096 per reference image | | | | MiniMax H3-Image · MiniMax | Image to image | 2K | $0.036/img\+ $0.0096 per reference image | | | ## What is the MiniMax H3-Image API? The MiniMax H3-Image API generates and edits images with MiniMax's H3-Image model through one Makernice key. Use model id minimax-h3-image; minimax-h3 is the video model. Text-to-image is priced per image; image-to-image is priced per image plus a rate for each reference image, including the first. ## Spec sheet Parameters, limits and billing rules to check before you call it. \[MODEL\] Model id `minimax-h3-image` · MiniMax \[MODES\] Modes `t2i` Text to image · `i2i` Image to image \[RES\] Resolution 1K (default) · 2K \[FRAMING\] Aspect ratio (t2i) 1:1 · 1:2 · 2:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 9:21 · 21:9 \[REFS\] Reference images Up to 16, in `reference_images` \[INPUT\] Image input JPEG / PNG / WebP, up to 10 MB each, or an https link. Uploaded images can be used for 6 days. \[SIZE\] Image size 128–8192 px per side, aspect ratio 1:4–4:1 \[OUTPUT\] Output Image. Files are kept about 30 days, so download them promptly. \[PRICE\] Price From $0.036/img · Quotes are locked for 12 minutes. Per-resolution prices are in the table above. \[GUARANTEE\] Failed runs Failed, timed-out or canceled-while-queued runs release the hold in full. ## 2 ways to generate, one endpoint Set mode, send the inputs it needs — that's it. ### Text to image mode: "t2i" · prompt Describe the image you want in the prompt. ### Image to image mode: "i2i" · reference\_images (≤ 16) Add up to 16 reference images, then describe the edit or the new image. ## What you can build with this model Workflows this model is a good fit for. 01 ### Social formats Make 4:5 feed posts, 9:16 stories and 9:21 tall banners from the same prompt. [Try it in the playground](https://makernice.com/models/minimax-h3-image/#playground) 02 ### Many-reference edits Send up to 16 reference images to merge products, outfits or characters into one picture. [Try it in the playground](https://makernice.com/models/minimax-h3-image/#playground) 03 ### Stills for H3 video Generate a still here and pass it as image\_url to MiniMax H3 for image-to-video. [Try it in the playground](https://makernice.com/models/minimax-h3-image/#playground) ## Why run MiniMax H3-Image on Makernice ### Quote before you pay Every run gets an exact quote first, locked for 12 minutes. You're charged that amount — never more. ### Failed runs are free The hold is converted to a charge when the run completes. If a run fails or times out, the hold is released in full, and so does canceling while it's queued. Note: if a finished output is blocked by output moderation for a policy violation, the run is still charged. You can contact support for a manual review. ### Switch models with one field Same request, key, balance and console for all 19 models. Not happy with the result? Change model and run it again. ### Prepaid, no subscription Top up a US-dollar balance and pay per run. No monthly fee, no subscription. ### Your balance never expires Topped-up balance stays in your account indefinitely. No inactivity fees, no decay. ### Automatic failover If an upstream channel goes down, your request is routed to a backup channel automatically — no code changes on your side. ## Integrate MiniMax H3-Image in three steps Quote, hold, charge or release — each step shows how billing works. \[01\] ### Create an API key Sign in, top up and create a key in the console. Set a spend limit per key so nothing runs away. // Console → API keys \[02\] ### Quote and create POST the input to /v1/generations/quote with the model field set to minimax-h3-image. The price is locked for 12 minutes; creating the generation with the quote id holds that amount from your balance. // POST /v1/generations/quote// POST /v1/generations \[03\] ### Poll the result GET /v1/generations/{id} until the status is succeeded, then download the output. You're charged the quoted amount on success; failed, timed-out or canceled-while-queued runs release the hold in full. // GET /v1/generations/{id} Retrying with the same `Idempotency-Key` returns the same generation instead of charging twice. Docs/API/MINIMAX-H3-IMAGE ## API reference Copy-paste requests for this model. The full parameter reference is in the docs. ``` curl https://api.makernice.com/v1/generations/quote \ -H "Authorization: Bearer $MAKERNICE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "minimax-h3-image", "mode": "t2i", "prompt": "Editorial portrait of a jazz trumpeter on a smoky stage, warm spotlight, film grain, 4:5 framing.", "resolution": "1k" }' ``` ### Invalid request 400 invalid\_request names each failing field. Fields the mode doesn't use are rejected too. Nothing is held. ### Key or balance 401 means a missing or invalid key; 402 means the balance or the key's spend limit isn't enough. ### Quote problems A changed price-affecting field returns 422 quote\_mismatch; an expired quote 410; a used one 409. Get a new quote. ### Failed generation A failed generation is never charged — the hold is released in full. Note: if a finished output is blocked by output moderation for a policy violation, the run is still charged. You can contact support for a manual review. Keep the generation id and retry when you're ready. ## Frequently asked questions Common questions about this model. #### What is MiniMax H3-Image? MiniMax H3-Image is an AI image generation model from MiniMax, available through the Makernice API with one key and one prepaid balance. MiniMax H3-Image: generate images in 13 aspect ratios or edit with up to 16 reference images, at 1K or 2K. #### How many reference images does MiniMax H3-Image support? Up to 16 reference images, sent in reference\_images in image to image mode. #### How much does MiniMax H3-Image cost per image? MiniMax H3-Image costs, per image: text to image $0.036 at 1K and 2K; image to image $0.036 + $0.0096 per reference image at 1K and 2K (price list v14, as of November 11, 2026). Call POST /v1/generations/quote to get the exact amount before you run it. Failed runs are never charged. Note: if a finished output is blocked by output moderation for a policy violation, the run is still charged. You can contact support for a manual review. #### MiniMax H3-Image vs Seedream 5.0 Pro: which should I use? Choose MiniMax H3-Image for 13 aspect ratios and up to 16 reference images, with edit pricing that follows how many you send. Choose Seedream 5.0 Pro for a flat image-to-image price with up to 10 reference images and a chosen aspect ratio when editing. #### Is MiniMax H3-Image the same as MiniMax H3? No. MiniMax H3 (minimax-h3) makes videos; MiniMax H3-Image (minimax-h3-image) makes still images. MiniMax H3 and MiniMax H3-Image have separate model ids and separate prices. #### Which aspect ratios does MiniMax H3-Image support? Text-to-image supports 1:1, 1:2, 2:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21 and 21:9. Image-to-image doesn't take aspect\_ratio; the output follows your reference images. #### How are reference images priced on MiniMax H3-Image? Image-to-image costs a base rate per image plus a rate for each reference image, including the first. The price table on this page lists both, and POST /v1/generations/quote returns the exact amount for the number of images you send. ## More Posts [MiniMax H3-Image vs Seedream 5.5: Ratios, References and Price](https://makernice.com/blog/minimax-h3-image-vs-seedream-5-5/) Comparing with Seedream 5.5? Full comparison → [MiniMax H3-Image vs Seedream 5.5](https://makernice.com/blog/minimax-h3-image-vs-seedream-5-5/) ## Related models [Compare all models](https://makernice.com/models/) Similar models worth comparing. Image ### Seedream 5.0 Pro \-22% ByteDance's Seedream 5.0 Pro: generate or edit images at 1K or 2K, guided by up to 10 reference images. By ByteDanceFrom $0.0351/img https://makernice.com/models/seedream-5-0-pro/ Image ### Seedream 5.0 \-4% Blend up to 14 reference images into one: Seedream 5.0 is built for character sheets, collages and style fusion, priced as a single 2K tier. By ByteDanceFrom $0.0336/img https://makernice.com/models/seedream-5-0/ Image ### Seedream 5.5 ByteDance's Seedream 5.5: generate or edit images at 1K or 2K, with up to 10 reference images and an optional transparent background. By ByteDanceFrom $0.0156/img https://makernice.com/models/seedream-5-5/ Image ### Qwen3 Image \-21% Everyday images and quick edits: Alibaba's Qwen3 Image at 1K or 2K, eight aspect ratios, up to 3 references. By AlibabaFrom $0.0236/img https://makernice.com/models/qwen3-image/ ● Start building ## See what it does with your prompt Test it in the playground, or grab an API key and ship it today. [Try MiniMax H3-Image →](https://makernice.com/models/minimax-h3-image/#playground)[Read the API docs](https://makernice.com/docs/) - Quote before you pay - Failed runs are free - Prepaid, no subscription - Balance never expires