MiniMax h3 Image
Generate 1K, 2K, or 4K images from text or up to 16 reference images with MiniMax H3 Image. Turn a product photo, room image, or layout sketch into a new composition, or describe a focused edit while preserving the surrounding scene. Use it to draft campaign posters, compare product materials, and explore illustrated layouts or alternative styles for the same subject. Review lettering, textures, and composition before using the result in a final design. The model page includes request examples, parameters, and pricing references.
Overview for yir
MiniMax H3 Image API Guide for Visual Design and Reference Editing
MiniMax H3 Image creates and edits still images from a written brief and visual references. On OpenAny, choose 1K, 2K, or 4K output for poster concepts, product scenes, editorial images, and illustration. Use up to sixteen reference images when a subject, setting, material, or layout needs a visual guide.
A useful brief names the subject, framing, light, and intended use. For an edit, identify the change and the details that should remain intact. The image model is separate from MiniMax H3 video generation.
Example outputs
These are published MiniMax H3 Image showcase images. The OpenAny requests later in this guide are separate platform templates and have not been run to produce these examples.
MiniMax H3 Image showcase: Market spice stall
MiniMax H3 Image showcase: Hiking trail map poster
MiniMax H3 Image showcase: Fisherman mending a net
MiniMax H3 Image showcase: Library reading room at dusk
| Published example | What to check |
|---|---|
| Market spice stall | Inspect the balance, hands, glass containers, cloth, and the way light falls across the working surface. |
| Hiking trail map poster | Check the title, small labels, legend, and the relationship between numbered routes. Review all place names and distances. |
| Fisherman mending a net | Review the fingers, fine netting, worn skin, and contact between hands, rope, and fabric. |
| Library reading room at dusk | Check shelf geometry, books, the ladder, and how warm interior light meets the darker corners of the room. |
Open an image to inspect its published preview. These files are showcase previews; no claim is made that the linked preview files are full-resolution 4K originals. Published model showcase · MiniMax model announcement
Choose an input mode and output size
| Setting | OpenAny configuration |
|---|---|
| Text to image | Describe the full composition and any short text that should appear. |
| Image to image | Supply 1–16 public HTTPS image URLs with the reference_image role. Refer to each image by its position in the prompt. |
| prompt | Required in both modes. The public Standard input limit is 20,000 characters. |
| resolution | 1K, 2K, or 4K; default 4K. |
| aspect_ratio | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9; default 1:1. |
| size | Optional exact pixel dimensions from the table below. Keep resolution and aspect_ratio consistent with the size. |
| n | 1 image per job. Submit separate jobs for additional variations. |
Exact pixel sizes
Leave size unset for normal resolution-based requests. Exact pixels are available only on compatible channels; conflicting selections are rejected. A 4K channel may return different native dimensions when size is not explicitly constrained.
| Aspect ratio | 1K size | 2K size | 4K size |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 4096x4096 |
| 2:3 | 832x1248 | 1664x2496 | 3328x4992 |
| 3:2 | 1248x832 | 2496x1664 | 4992x3328 |
| 3:4 | 896x1184 | 1760x2368 | 3520x4704 |
| 4:3 | 1184x896 | 2368x1760 | 4704x3520 |
| 4:5 | 928x1152 | 1824x2304 | 3648x4576 |
| 5:4 | 1152x928 | 2304x1824 | 4576x3648 |
| 9:16 | 768x1376 | 1536x2720 | 3072x5440 |
| 16:9 | 1376x768 | 2720x1536 | 5440x3072 |
| 21:9 | 1568x672 | 3136x1344 | 6240x2656 |
Quickstart
In the Playground, select Text to image. This platform template asks for a field-guide poster with a clear title and separated visual panels. Send POST https://api.openany.si/v1/images with Authorization: Bearer $OPENANY_API_KEY and Content-Type: application/json.
{
"model": "minimax-h3-image",
"route": {
"provider": "yir"
},
"route_mode": "balanced",
"input": {
"type": "text",
"prompt": "Create an illustrated field-guide poster titled FOREST NOTES. Show a fox, pine branches, a folded trail map, and three clearly separated detail panels. Use readable short English labels, muted green ink, warm ivory paper, and a balanced editorial layout."
},
"parameters": {
"resolution": "4K",
"aspect_ratio": "1:1",
"n": 1
}
}Save the returned task ID. Poll GET /v1/images/{task_id} with the same authorization header until the task succeeds, then read the image URLs from result.files. A queued or running task is still in progress.
curl 'https://api.openany.si/v1/images/YOUR_TASK_ID' \
-H 'Authorization: Bearer $OPENANY_API_KEY'Replace YOUR_TASK_ID with the submitted task's ID. Review the text, panel order, fine detail, and overall layout before publishing the image.
Edit a reference image
The editing template uses the published library image as a base reference. It asks for one upholstery-color change while preserving the surrounding room. Replace the URL with your own directly accessible HTTPS image when adapting the request.
Base reference: published MiniMax H3 Image library example
{
"model": "minimax-h3-image",
"route": {
"provider": "yir"
},
"route_mode": "balanced",
"input": {
"type": "image",
"prompt": "Use the reference as the base image. Change the upholstery of the foreground reading chair to deep forest green. Preserve the chair shape, room layout, bookshelves, ladder, lighting, and camera angle.",
"references": [
{
"role": "reference_image",
"url": "https://yir.ai/images/models/minimax-h3-image/rail-reading-room.jpg"
}
]
},
"parameters": {
"resolution": "4K",
"aspect_ratio": "1:1",
"n": 1
}
}No edited output is shown because the template has not been executed. Compare the chair material, room layout, shelves, and lighting before accepting a result. For multiple references, append more objects to input.references, up to sixteen in total, and explain each reference's role in the prompt.
Billing and usage limits
The following OpenAny reference selling prices include the current 10% platform markup. They are based on the lowest published fixed-channel prices collected on November 12, 2026. Each additional reference image adds USD 0.00275, including markup.
Final charge = the completed task's settled generation cost × 1.10. The amounts below already include this markup. The actual channel, exact-size availability, and fallback behavior may change the settled cost.
| Input | 1K, per image | 2K, per image | 4K, per image |
|---|---|---|---|
| Text only | USD 0.0099 | USD 0.0099 | USD 0.03025 |
| 1 reference image | USD 0.01265 | USD 0.01265 | USD 0.033 |
| 2 reference images | USD 0.0154 | USD 0.0154 | USD 0.03575 |
| 3 reference images | USD 0.01815 | USD 0.01815 | USD 0.0385 |
| 4 reference images | USD 0.0209 | USD 0.0209 | USD 0.04125 |
| 5 reference images | USD 0.02365 | USD 0.02365 | USD 0.044 |
| 6 reference images | USD 0.0264 | USD 0.0264 | USD 0.04675 |
| 7 reference images | USD 0.02915 | USD 0.02915 | USD 0.0495 |
| 8 reference images | USD 0.0319 | USD 0.0319 | USD 0.05225 |
| 9 reference images | USD 0.03465 | USD 0.03465 | USD 0.055 |
| 10 reference images | USD 0.0374 | USD 0.0374 | USD 0.05775 |
| 11 reference images | USD 0.04015 | USD 0.04015 | USD 0.0605 |
| 12 reference images | USD 0.0429 | USD 0.0429 | USD 0.06325 |
| 13 reference images | USD 0.04565 | USD 0.04565 | USD 0.066 |
| 14 reference images | USD 0.0484 | USD 0.0484 | USD 0.06875 |
| 15 reference images | USD 0.05115 | USD 0.05115 | USD 0.0715 |
| 16 reference images | USD 0.0539 | USD 0.0539 | USD 0.07425 |
MiniMax's direct API uses token-based rates, so its published image examples are estimates rather than fixed per-image tariffs. The official pricing page also lists a 50% promotion on total request cost for delivered images of at least 16,600,000 pixels, ending November 17, 2026 at 16:00 UTC, exclusive. An output labeled 4K is not sufficient on its own to establish promotion eligibility.
The collected marketplace image-input token rate differs from the current manufacturer rate card, so no official-savings percentage is asserted here. The Playground reference table is a guide; the completed task's final bill is authoritative. MiniMax official pricing and promotion conditions
Common questions
Can I pass image URLs?
Yes. Provide public HTTPS image URLs with the reference_image role. The public input guide allows URLs up to 2,048 characters and imports the media at submission.
Why does this route expose fewer controls than the native API?
The native manufacturer API and this public model contract are different interfaces. This route exposes resolution, aspect_ratio, size, and n. Native batch sizes, response formats, prompt enhancement, streaming, and other controls are not declared by this public contract.
How many images does one job return?
One on this route. Submit separate jobs for additional outputs.
Are these requests the original showcase prompts?
The displayed requests are OpenAny platform templates. The linked showcase images are existing published examples; neither template is presented as the request that produced those images.