MiniMax H3 Image API：生成、编辑与真实定价

同模型跨平台价格对比: Cheap MiniMax H3 Image API · 2026-11-13

MiniMax H3 Image 的能力与托管 API 限制

评估 H3 Image 最有力的理由是它统一的生成与编辑工作流：描述一个新素材，提供产品或角色参考，然后要求进行针对性更改。MiniMax 还发布了用于本地部署的权重。已发布的能力声明并不保证每次输出都能精确保留 logo、排版或身份特征。

托管 API 功能	文档约定的内容
生成	POST /v1/images/generations
编辑	POST /v1/images/edits，1–16 张参考图
提示词	最多 32,000 个字符；若不启用增强，仅前约 4,096 个 token 生效
输出尺寸	655,360–20,000,000 像素；宽高比从 1:3 到 3:1
输出数量	n 从 1 到 10
格式	默认 JPEG；支持 PNG 或 WebP
响应	URL 或非流式 Base64；支持原生 SSE
不支持的控制项	蒙版编辑、透明背景和预览图

参考文件必须满足 MiniMax 的输入限制：JPG/JPEG、PNG、WebP、HEIC 或 HEIF，每个维度 128–8,192 像素，长边与短边之比最多 4:1，请求体总计最多 64 MiB。Base64 会增加请求体积。请使用可访问的图像 URL 或大小合适的上传文件；模型能够接受 16 张图像并不意味着可以突破请求体大小限制。

此 API 中的“4K”是一种面积设置。 area: "4K" 目标约为 4096 × 4096 像素，具体尺寸根据宽高比推导。在 16:9 下，文档记录的输出为 5472 × 3072，而非 4096 × 2304。如需指定明确尺寸，请发送 size: "WIDTHxHEIGHT" 并省略 area 和 aspect_ratio。若按面积设置尺寸，请使用 size: "auto"、area 和 aspect_ratio。请检查 data[].size 以及下载图像的实际尺寸。

MiniMax H3 Image 的价格是多少？

对于当前 APIMaster Standard 路由，常规价格计算方式为：

USD = (text_input_tokens × 2.30
     + image_input_tokens × 1.50
     + image_output_tokens × 3.80) / 1,000,000

请分别使用文本和图像用量字段；不要将所有输入 token 都按文本计费后再重复加上图像输入。提示词增强会计入计费文本 token，因此仅凭分辨率无法决定总价。账户专属系数（如适用）以及计费舍入都可能影响最终扣费。

MiniMax 官方的说明性 Standard 总计展示了账单规模。这些是示例，并非 APIMaster 的固定费率或我们的实测平均值：

任务	1K：1024 × 1024	2K：2048 × 2048	4K：4096 × 4096，常规费率
文生图	$0.02179	$0.02333	$0.06879
使用一张 1K 参考图编辑	$0.02654	$0.02658	$0.07312
使用三张 1K 参考图编辑	$0.03563	$0.04177	$0.07914

作为参考，按第一个示例，1,000 次文生图请求约为 $21.79；这是说明性的 token 预算计算，并非预付套餐。实际提示词和增强可能会改变这一数字。Nano Banana 2.1 在 APIMaster 采用不同的、基于分辨率的计费合同，1,000 张 1K 图像起价为 $15.12，另有单独报价的条件。

官方的 4K 五折促销适用于 APIMaster 吗？

请不要想当然认为适用。 MiniMax 宣传 Standard 和 Highspeed 的总请求费用五折优惠，截止至 2026 年 11 月 17 日 16:00 UTC（不含）——即北京时间 11 月 18 日 00:00——条件是最终交付图像至少达到 16,600,000 像素。其方形 4K 文生图示例在该优惠期间从 $0.06879 降至 $0.03439。

4096 × 4096 输出按面积符合条件；4096 × 2304 不符合。仅有“4K”标签并不足够。当前 APIMaster 公开路由使用常规 token 费率，不包含此临时促销。 请比较实际的结算/用量合同，而非 MiniMax 的活动宣传。截止日期之后，不应再将促销示例用作当前价格。

MiniMax H3 Image API 示例：文生图

创建 APIMaster 账户，为付费图像请求充值，然后在 API keys 中创建密钥。在环境中设置 APIMASTER_API_KEY。此示例使用 Standard 路由的精确、区分大小写的模型 ID：

import os
import requests

base_url = "https://apimaster.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['APIMASTER_API_KEY']}"}
response = requests.post(
    f"{base_url}/images/generations",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "A studio product photo of a matte blue teapot and two pears on a cream table, soft daylight, no text.",
        "size": "auto",
        "aspect_ratio": "16:9",
        "area": "2K",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
response.raise_for_status()
result = response.json()
for item in result.get("data", []):
    if item.get("error"):
        print("Image failed:", item["error"])
    else:
        print(item.get("url"), item.get("size"))
print("Usage:", result.get("usage"))

这是一个请求示例，并非图像质量基准。请及时下载成功的输出 URL 并自行存储文件。请检查每张图片的错误：当 n > 1 时，HTTP 200 也可能包含失败的图片。超时并不证明请求被拒绝。 H3 生成不是幂等的，因此自动重试可能会产生另一次付费生成。如果使用 OpenAI SDK，请设置足够长的超时时间和 max_retries=0。

MiniMax H3 Image 编辑：参考图与提示词控制

对于 JSON 编辑，请在 images[].image_url 中发送参考 URL。不要将 Nano Banana 的 image_urls 字段复制到 H3 请求中。请将示例 URL 替换为您自己的可访问素材：

edit = requests.post(
    f"{base_url}/images/edits",
    headers=headers,
    json={
        "model": "MiniMax-H3-Image",
        "prompt": "Keep the product shape and label from image 1. Use the background palette from image 2. Do not add text or change the product.",
        "images": [
            {"image_url": "https://example.com/product.png"},
            {"image_url": "https://example.com/palette.png"},
        ],
        "size": "2048x2048",
        "n": 1,
        "response_format": "url",
    },
    timeout=600,
)
edit.raise_for_status()
print(edit.json())

APIMaster 现有的 11 月 11 日集成验收检查覆盖了 HTTP 引用、data URI、multipart 上传、多参考图编辑、SSE 以及 1K/2K/4K 解码输出。一次受控的双参考图测试保留了四个彩色形状和两个短标签。这些是使用简单素材的接口与计费检查，并非广泛的摄影或排版评估；它们不能证明其优于其他模型。

生成默认使用提示词增强；您可以设置 disable_prompt_enhanced: true 并同时提供固定尺寸或固定宽高比来禁用它。编辑始终使用增强。在诊断意外更改时，请检查 revised_prompt。对于产品类工作，请明确指定必须保持不变的内容、说明每张参考图的作用，并在发布前验证渲染出的标签。

Standard 与 Highspeed，以及开放权重与托管 API

Highspeed 使用相同的文档 API 参数，但其官方图像输入和图像输出费率是 Standard 的两倍；文本输入保持 $2.30/M。APIMaster 目前仅上架 Standard。 MiniMax 的发布速度声明取决于模型变体、尺寸和部署方式，并非 APIMaster 的实测延迟保证。

官方 Hugging Face 仓库提供了权重及集成方案，包括 Diffusers、SGLang、vLLM-Omni 和 ComfyUI。其 BF16 checkpoint 约为 68.65 GB，另有约 66.7 GB 的独立文本编码器。下载大小并非完整的 GPU 显存估算。本地权重使用 MiniMax H3 Image 社区许可，因此部署前请审阅该许可；“开放权重”并不意味着可在 MIT 或 Apache 下无限制使用。

使用托管访问可在不搭建推理基础设施的情况下评估提示词。当对推理的控制足以证明 GPU、维护和许可工作是值得的，再考虑本地部署。本地流水线限制与托管 API 限制是不同的合同。

FAQ

MiniMax H3 Image 与 MiniMax H3 视频是同一个吗？

不是。H3 Image 使用 MiniMax-H3-Image 生成和编辑静态图像。H3 视频系列有不同的模型 ID、端点和计费。请参阅单独的 MiniMax H3 视频指南。

MiniMax H3 Image 在 APIMaster 上可用吗？

可用。11 月 13 日的检查发现一条已启用的公开 Standard 路由，计费为 $2.30/M 文本输入、$1.50/M 图像输入和 $3.80/M 图像输出。Highspeed 没有公开路由。发送请求前请检查实时模型卡片。

H3 Image 是按每张图片 $0.02 固定价格的 API 吗？

不是。官方每张图片示例是说明性总计。实际 token 用量、提示词增强、参考输入和输出尺寸决定账单。当前 APIMaster 路由使用常规 token 公式。

H3 Image 可以用 16 张参考图或蒙版进行编辑吗？

它在格式和请求大小限制内记录最多 16 张参考图。不支持蒙版编辑和透明背景。基于参考图的指令并不保证像素级精确保留。

H3 Image 与 Nano Banana 2.1 哪个更便宜？

对于示例中的 1K 文生图任务，H3 的官方常规示例为 $0.02179，而 APIMaster Nano Banana 2.1 每张 1K 图像为 $0.01512 起。这是将示例 token 总计与分辨率报价进行比较；请针对您的提示词测量实际被接受输出的成本。请参阅专门对比。

来源与后续步骤

来源检查时间：2026 年 11 月 13 日：MiniMax 发布、托管 API 指南、官方定价与促销、模型权重与许可、Google 图像定价，以及 APIMaster 实时市场卡片。能力描述来自各自供应商；价格检查和带有日期的 APIMaster 集成观察已分别标明。

打开 H3 Image 卡片、注册、创建 API 密钥，并将 MiniMax-H3-Image 发送至 https://apimaster.ai/v1。如需具有不同计费合同的折扣替代方案，请比较 Nano Banana 2.1 路由，目前相对 Google 的图像输出参考价最高低 55%。