# MiniMax H3 Image

> MiniMax H3 Image(模型 ID MiniMax-H3-Image,RouteMux 调用名 minimax/minimax-h3-image)是 MiniMax 的图像生成与图像编辑模型,支持文生图与基于 1 至 16 张参考图的改图,提供 1K、2K 与 4K(最高约 1600 万像素)三档分辨率或自定义像素尺寸,单次请求可生成 1 至 10 张图像,按输入与输出 token 计费。同系列还有高速版 minimax/minimax-h3-image-highspeed:两者接口、参数范围与能力上限完全一致,标准版是日常出图与批量任务的家族默认档,高速版生成更快、延迟更低。

Canonical: https://routemux.com/zh/minimax/minimax-h3-image
Provider: MiniMax

## Key facts

| Field | Value |
| --- | --- |
| Model ID | minimax/minimax-h3-image |
| Official model ID | MiniMax-H3-Image |
| Input modalities | text, image |
| Output modalities | image |
| Capabilities | Image Generation, Image Edit |
| Upstream release | 2026-11-10 |
| Availability | available |

## Pricing

- RouteMux: $1.9 per 1M tokens
- Official: $3.8 per 1M tokens
- Saving vs official: 50%
- Official price source: https://platform.minimax.io/docs/pricing/overview, verified 2026-11-11

Billing is prepaid wallet, charged per successful request only.

## API access

Base URL: https://api.routemux.com

Supported protocols:

- openai_images

## What is MiniMax H3 Image

MiniMax H3 Image(模型 ID MiniMax-H3-Image,RouteMux 调用名 minimax/minimax-h3-image)是 MiniMax 的图像生成与图像编辑模型,支持文生图与基于 1 至 16 张参考图的改图,提供 1K、2K 与 4K(最高约 1600 万像素)三档分辨率或自定义像素尺寸,单次请求可生成 1 至 10 张图像,按输入与输出 token 计费。同系列还有高速版 minimax/minimax-h3-image-highspeed:两者接口、参数范围与能力上限完全一致,标准版是日常出图与批量任务的家族默认档,高速版生成更快、延迟更低。

在 RouteMux 上,它走 OpenAI Images 兼容接口:文生图请求 POST https://api.routemux.com/v1/images/generations,图像编辑请求 POST https://api.routemux.com/v1/images/edits。提示词 prompt 最长 32000 个 Unicode 字符,单次可生成 n=1 到 10 张图。图像编辑支持传入 1 到 16 张参考图:JSON 请求体传 images 数组(每项带 image_url 字段),multipart 表单传 image 或 image[] 文件;不支持 mask 局部遮罩与流式输出(stream 只能省略或为 false)。

尺寸与画幅有两种指定方式:一是用 area("1K"、"2K"、"4K",默认 "4K")搭配 aspect_ratio("auto" 或 X:Y,X 与 Y 为 1 到 300 的整数且宽高比在 1:3 到 3:1 之间,例如 1:1、16:9、9:16、21:9、3:1、1:3);二是直接传像素尺寸 size(WxH,总像素面积在 655360 到 20000000 之间且宽高比在 1:3 到 3:1 之间,此时不能同时传 aspect_ratio 或 area;size 也可传 "auto")。文生图默认开启提示词扩写;若将 disable_prompt_enhanced 设为 true 关闭扩写,则必须显式传入 WxH 格式的 size 或 X:Y 格式的 aspect_ratio(图像编辑固定开启扩写,不支持传 disable_prompt_enhanced=true)。输出格式 output_format 支持 "png"、"jpeg"、"jpg"、"webp",返回格式 response_format 支持 "url" 或 "b64_json"。压缩质量 output_compression 为 0 到 100 的整数(缺省 95,只对 jpeg 与 webp 生效)。参考图 image_url 需为公网 https 地址或 data URL,不支持 mm_file:// 引用。

由于图像生成属于非幂等操作(non_idempotent),客户端断开或超时后上游仍会继续生成并计费,重发请求会导致重复出图与双倍扣费。RouteMux 网关对该模型仅在上游返回 HTTP 429 时重试,对 5xx、超时和网络错误都不重试;客户端调用时也请将 OpenAI SDK 的 max_retries(TypeScript SDK 为 maxRetries)设为 0、curl 不加 --retry,避免客户端重发导致重复扣费。

## Key capabilities

- **1K/2K/4K 与灵活画幅** — 支持 area 1K/2K/4K(最高约 1600 万像素)三档或像素级 size(65.5 万至 2000 万像素),宽高比覆盖 1:3 到 3:1。
- **1–16 张参考图改图** — /v1/images/edits 支持一次传入 1 到 16 张参考图进行图像编辑,文生图与改图单次均可输出 1 到 10 张。
- **非幂等防重扣保护** — 网关仅在上游返回 429 时重试,5xx、超时和网络错误均不重试;客户端 SDK 请设 max_retries=0(或 maxRetries: 0)。
- **比官方价省 50%** — 按文本输入、图像输入与图像输出 token 计费,在 RouteMux 上调用比 MiniMax 官方定价便宜 50%。

## Use cases

- **高分辨率与多画幅素材生成** — 通过 area 1K/2K/4K(约 1600 万像素)或自定义 WxH 像素尺寸,配合 1:3 至 3:1 宽高比与最长 32000 字符提示词生成多规格图像素材。
- **多参考图主体一致性编辑** — 在 /v1/images/edits 中一次传入 1 到 16 张参考图并配合 n=1 到 10 批量生成,基于同一组参考图完成改图与多方案筛选。

## Other variants in this family

- MiniMax H3 Image Highspeed (`minimax/minimax-h3-image-highspeed`)

## Sources

- [MiniMax 图像生成文档](https://platform.minimax.io/docs/guides/image-generation)
- [MiniMax 定价总览](https://platform.minimax.io/docs/pricing/overview)

_Content reviewed by the RouteMux team on 2026-11-11._