MiniMax H3-Image — 13 aspect ratios, up to 16 references

Name: MiniMax H3-Image
Brand: MiniMax
SKU: minimax-h3-image

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

Input

Prompt

Resolution

Aspect ratio

ResultPreview

Estimated price$0.04$0.036/img

Checking your session…

Try one of these prompts

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

$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
MiniMax H3-Image MiniMax	Text to image1K	1K	$0.036/img
MiniMax H3-Image MiniMax	Text to image2K	2K	$0.036/img
MiniMax H3-Image MiniMax	Image to image1K	1K	$0.036/img+ $0.0096 per reference image
MiniMax H3-Image MiniMax	Image to image2K	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.

Social formats

Make 4:5 feed posts, 9:16 stories and 9:21 tall banners from the same prompt.

Try it in the playground

Many-reference edits

Send up to 16 reference images to merge products, outfits or characters into one picture.

Try it in the playground

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

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

// 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.

MiniMax H3-Image vs Seedream 5.5: Ratios, References and Price

Comparing with Seedream 5.5? Full comparison → MiniMax H3-Image vs Seedream 5.5