MiniMax h3 Image

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.

Published price
From $0.010 / image
Billing unit
/ image
Context / Max output
— / —
Listed routes
1
MODEL OVERVIEW

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.

Published exampleWhat to check
Market spice stallInspect the balance, hands, glass containers, cloth, and the way light falls across the working surface.
Hiking trail map posterCheck the title, small labels, legend, and the relationship between numbered routes. Review all place names and distances.
Fisherman mending a netReview the fingers, fine netting, worn skin, and contact between hands, rope, and fabric.
Library reading room at duskCheck 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

SettingOpenAny configuration
Text to imageDescribe the full composition and any short text that should appear.
Image to imageSupply 1–16 public HTTPS image URLs with the reference_image role. Refer to each image by its position in the prompt.
promptRequired in both modes. The public Standard input limit is 20,000 characters.
resolution1K, 2K, or 4K; default 4K.
aspect_ratio1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9; default 1:1.
sizeOptional exact pixel dimensions from the table below. Keep resolution and aspect_ratio consistent with the size.
n1 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 ratio1K size2K size4K size
1:11024x10242048x20484096x4096
2:3832x12481664x24963328x4992
3:21248x8322496x16644992x3328
3:4896x11841760x23683520x4704
4:31184x8962368x17604704x3520
4:5928x11521824x23043648x4576
5:41152x9282304x18244576x3648
9:16768x13761536x27203072x5440
16:91376x7682720x15365440x3072
21:91568x6723136x13446240x2656

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.

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.

bash
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

json
{
  "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.

Input1K, per image2K, per image4K, per image
Text onlyUSD 0.0099USD 0.0099USD 0.03025
1 reference imageUSD 0.01265USD 0.01265USD 0.033
2 reference imagesUSD 0.0154USD 0.0154USD 0.03575
3 reference imagesUSD 0.01815USD 0.01815USD 0.0385
4 reference imagesUSD 0.0209USD 0.0209USD 0.04125
5 reference imagesUSD 0.02365USD 0.02365USD 0.044
6 reference imagesUSD 0.0264USD 0.0264USD 0.04675
7 reference imagesUSD 0.02915USD 0.02915USD 0.0495
8 reference imagesUSD 0.0319USD 0.0319USD 0.05225
9 reference imagesUSD 0.03465USD 0.03465USD 0.055
10 reference imagesUSD 0.0374USD 0.0374USD 0.05775
11 reference imagesUSD 0.04015USD 0.04015USD 0.0605
12 reference imagesUSD 0.0429USD 0.0429USD 0.06325
13 reference imagesUSD 0.04565USD 0.04565USD 0.066
14 reference imagesUSD 0.0484USD 0.0484USD 0.06875
15 reference imagesUSD 0.05115USD 0.05115USD 0.0715
16 reference imagesUSD 0.0539USD 0.0539USD 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.

Put the model to work.

Use Playground for a test, or inspect the API contract for your integration.

Model API questions

How do I call MiniMax h3 Image through OpenAny?

Use model ID minimax-h3-image with an OpenAny key and the operation published in this model's API tab. The model API base is https://api.openany.si/v1. Confirm the protocol and request schema; model availability does not imply every OpenAI API operation is supported.

How is MiniMax h3 Image billed?

Compare the published rate and billing unit of the selected provider route. Input, output and cache token rates may differ. Image, audio and video models can use other units. Recorded usage determines the charge under that route's billing contract.

Are Community and Verified routes the same as an official publisher API?

No. Inspect the provider name and supply classification for the specific route. A marketplace listing or a supply label is not a claim of publisher endorsement, identical service or measured uptime. Different route prices may reflect different supply and conditions.

Where do these prices come from, and when were they updated?

Rates come from the provider routes in OpenAny's public model catalog, not an independent quote from the model publisher. The catalog does not supply a price update timestamp. A page or catalog snapshot date is not a price revision date. Compare supply, billing units, tiers and conditions; a lower listed rate alone does not establish equivalent service or explain the price difference.

Use MiniMax h3 Image with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.