ShotyardShotyard

What Is MiniMax H3 Image? Specs, Pricing & Usage Guide

on 8 days ago

What Is MiniMax H3 Image? Specs, Pricing & Usage Guide

MiniMax H3 Image is MiniMax's model for generating still images from text and editing images with visual references. It is available through a hosted API and downloadable weights. For creators, the practical questions are what it can produce, what each attempt costs, and how much control a brief gives you.

The specifications and prices below were checked on November 12, 2026. The guide also walks through a first request and the checks before delivery. Its illustrations are AI-generated editorial concepts, not examples produced with H3 Image.

What is MiniMax H3 Image, and who is it for?

The official model card describes a diffusion-based image model whose transformer has 33.1 billion parameters. A text encoder interprets the instructions and references, and an image decoder turns the generated representation into pixels. That architecture detail does not establish whether a particular product photo will pass review.

A useful evaluation starts with a real deliverable: a campaign concept, a product scene, or an illustration with a defined composition. Text-to-image suits a scene you can describe from scratch. Image editing becomes relevant when an existing subject or visual reference should guide the result.

Creative teams need to know how many revisions it takes to meet a brief. Developers also need to check integration, billing, and operating conditions. Review both: an API response confirms that the request ran, while someone still has to decide whether the image is usable.

MiniMax H3 Image specs that affect your project

The image generation guide documents the following hosted API limits:

SpecificationPublished support
Generation modesText-to-image and image editing
Reference images for editing1–16
Output images per request1–10
Maximum output area20,000,000 pixels
Output formatsJPEG, PNG, WebP
Prompt lengthUp to 32,000 characters
Unsupported featuresMasked edits, transparent backgrounds, preview images

You can provide explicit width and height or choose an aspect ratio with an area level. Do not mix those sizing methods. The guide's 2K plus 16:9 example returns 2720 × 1536, so inspect the actual dimensions instead of interpreting “2K” as a fixed width.

Choose the destination before choosing a size. A wide campaign banner needs room for copy and a different crop from a square catalog tile. Write down the required framing, export dimensions, and background treatment before generating. Otherwise, you may approve an attractive composition that cannot fit the placement.

MiniMax H3 Image pricing: understand the bill

The official pricing overview lists these USD rates per million tokens:

ModelText inputImage inputImage output
MiniMax-H3-Image$2.30$1.50$3.80
MiniMax-H3-Image-Highspeed$2.30$3.00$7.60

Multiply each category's tokens by its rate, add the amounts, and divide by one million. Highspeed doubles the image token rates while leaving the text rate unchanged. This does not mean every request costs exactly twice as much.

MiniMax's Standard 1024 × 1024 text-to-image example totals $0.02179. That is an illustration, not a guaranteed flat price. A temporary offer halves total request cost for both models when the delivered image reaches 16,600,000 pixels; it ends November 17, 2026, at 16:00 UTC, exclusive. Check the terms again before relying on it.

For recurring budgets, use regular rates and measure cost per accepted asset. If a hypothetical pilot costs $6 and yields 20 approved images, that is $0.30 per approved image before staff time. This arithmetic is a planning example, not an H3 measurement. Our MiniMax H3 Image pricing guide explains the cost categories in more detail.

How to use the MiniMax API for a first image

A blank brief card, bottle reference photo, and finished composition illustrate an image-generation workflow

Start with one image and a brief with clear acceptance criteria. “An attractive product photo” leaves too much open. A more useful request specifies the subject, surface, lighting, camera angle, and empty space needed for the design.

Prepare a MiniMax API key and an account ready for paid requests. Keep the key in an environment variable. The following example follows the text-to-image API reference and requests one image:

curl --request POST 'https://api.minimax.io/v1/images/generations' \
  --header "Authorization: Bearer $MINIMAX_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-H3-Image",
    "prompt": "One unbranded amber glass pump bottle on pale stone, soft light from the left, three-quarter view, sage background, empty space on the right, no text.",
    "size": "1600x900",
    "n": 1,
    "response_format": "url",
    "output_format": "webp"
  }'

Prompt enhancement is enabled by default. Inspect data[].revised_prompt alongside the original brief. Check each item's error, even after an HTTP 200 response, then download successful images and retain the returned size, usage, and request_id for your records.

An interrupted connection deserves care: generation requests are not idempotent, so resubmitting can generate another image and another charge. Investigate before retrying automatically. The documented server wait is up to 600 seconds; allow at least that long in clients with an explicit timeout.

Compare the result with the brief before changing anything. If framing is wrong, revise the framing instruction while keeping lighting and subject fixed. Changing several instructions together makes it difficult to identify what helped. Save the accepted prompt and the rejected alternatives with short notes, such as “insufficient space for headline.”

Use references deliberately, then inspect the result

A magnifying glass over a bottle print illustrates checking cap geometry, edges, and reflections

For image editing, the edit endpoint reference specifies POST /v1/images/edits and accepts reference URLs through images[].image_url. Editing always applies prompt enhancement.

Give each reference a job. For example, use image 1 for the bottle's appearance and image 2 for the desired surface and lighting. Explain which details should stay fixed. A clear instruction might ask for the bottle from image 1 on the surface from image 2, preserving its silhouette and cap while changing the background.

Review the result at the intended delivery size, then zoom in on details. For a product scene, inspect the silhouette, closure, reflections, contact shadow, and any lettering. Compare against the source product instead of judging only whether the image looks polished. A plausible bottle can still be the wrong bottle.

For a catalog listing, agree on which packaging details must match the real item. An early campaign concept may allow a looser brief. Decide who approves deviations before starting a batch, and keep text that needs precise typesetting in a separate design step. The product photography workflow expands this review process for commercial visuals.

Downloadable weights and licensing need separate attention

The model card lists a 68.65 GB image package and a separate 66.7 GB text encoder. Those are download sizes, not a complete GPU-memory requirement. Estimate deployment resources from the serving setup you intend to use; an API trial does not establish that local hosting will fit your hardware.

The community license is restrictive. Its defined territory excludes the EU, UK, South Korea, and United States. It also requires separate prior written authorization for third-party hosted services or when annualized revenue, including affiliates, exceeds $1 million.

Read the full applicable terms before choosing deployment or commercial use. Download access alone does not establish permission for your business, and the community license should not be treated as a complete statement of a provider's API contract.

FAQ

Is MiniMax H3 Image free to use?

The hosted API has published usage charges. Downloadable weights do not remove compute costs or license conditions. Plan around the route you will actually use, and verify any trial credit separately rather than assuming free generations.

Can it generate transparent PNGs or perform masked edits?

The hosted guide lists transparent backgrounds and masked edits as unsupported. PNG output is supported, but the file format alone does not imply transparency. Include a separate finishing step if the final asset needs a cutout.

Does 4K always mean a 3840 × 2160 image?

No. MiniMax's API uses 4K as an area level targeting 4096 × 4096 pixels, with dimensions calculated for the chosen aspect ratio. Check returned dimensions; a familiar screen-resolution label is not a reliable substitute for the API definition.

Conclusion

Give MiniMax H3 Image one real brief before committing a campaign to it. Check the delivered dimensions, review the result against the source material, and confirm the applicable license. If the images pass, use your recorded spend and revision count to budget the next batch.