Skip to content
PlaygroundDocsGet API key

Mage API · Image model

MiniMax H3 Image API

Native 16-megapixel images, open weights

Get an API keyTry MiniMax H3 Image in the playground
POST https://api.mage.space/v1/minimax_h3_image/generate

At a glance

The MiniMax H3 Image API runs MiniMax H3 Image through Mage at POST https://api.mage.space/v1/minimax_h3_image/generate. A request at the default settings costs 15 Gems (about $0.015), with no subscription. MiniMax H3 Image takes saved characters, references by @handle in the prompt.

  • ImageOutput
  • 1Variant
  • 15Gems per image, default
  • $0.015About, in USD

Overview

What the MiniMax H3 Image API does

An open-weights image model that renders up to 4K (about 16 megapixels) with rich detail and precise instruction following. Edit or combine up to 16 reference images, with LoRAs.

An open-weights image model for text-to-image and edits from up to 16 reference images, at 2K (about 4 megapixels) or native 4K (about 16 megapixels), with LoRAs. Distilled to six steps, it takes no negative prompt, step count, or guidance scale. Write the whole image in English; for an edit, say what to keep from each image, what changes, and then describe the result.

It accepts image, additional_images as inputs.

Quick start

Call the MiniMax H3 Image API

Set MAGE_API_KEY, submit to /minimax_h3_image/generate, and poll status_url until the request completes.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3_image/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "minimax-h3-image"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('minimax_h3_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'minimax-h3-image',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("minimax_h3_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "minimax-h3-image",
})

print(request["result"]["url"])

Models

MiniMax H3 Image model_id values

Send model_id to pick a variant. A request without one runs the default.

model_idNameDefault
minimax-h3-imageMiniMax H3 ImageYes

Options

MiniMax H3 Image parameters

Allowed values across all variants; a variant may offer fewer. The docs list the options per variant.

FieldValues
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution2k, 4k

Inputs

Media inputs MiniMax H3 Image accepts

Send each as an https URL, a data URL, or an upload of up to 100 MB.

FieldRole
imageThe reference image.
additional_imagesAdditional reference images.

Rules

What the MiniMax H3 Image API enforces

  • Send up to 16 reference images across image and additional_images, plus mentioned characters and references; the prompt names them image 1, image 2, ... in that order.

More image models

Other image generation APIs on Mage

FAQ

Frequently asked questions

How much does the MiniMax H3 Image API cost?
A MiniMax H3 Image request at the default settings (MiniMax H3 Image) costs 15 Gems, about $0.015. Other resolutions, durations, and variants change the price; the response reports the exact charge. A generation that fails is refunded; one Mage's content policy blocks is not.
What is the MiniMax H3 Image API endpoint?
POST https://api.mage.space/v1/minimax_h3_image/generate with an Authorization: Bearer header carrying your Mage API key. The response includes a status_url to poll for the result.
Which MiniMax H3 Image models can I call?
minimax-h3-image (MiniMax H3 Image). The default is MiniMax H3 Image.
Does MiniMax H3 Image support reference images or characters?
MiniMax H3 Image accepts image, additional_images. MiniMax H3 Image takes saved characters, references by @handle in the prompt.
Can I use MiniMax H3 Image from Claude or ChatGPT?
Yes. Connect the Mage MCP server to Claude, ChatGPT, Claude Code, Grok, or Cursor and ask for MiniMax H3 Image by name. Your assistant reads its options with get_model and quotes the price before it generates.
How long are MiniMax H3 Image results kept?
Results and inputs are kept for 30 days. Download anything you want to keep to your own storage.

Start building with Mage

One account, one Gems balance, every model. Pay only for what you generate.

Get an API keyTry MiniMax H3 Image in the playground