MiniMax H3 Image API
MiniMax H3 Image 是 MiniMax 于 2026 年 11 月 11 日发布的图片生成与编辑模型。在 APIMart 上使用模型 ID minimax-h3-image 调用，可做文生图和参考图编辑，支持 1K、2K、4K 三个档位。
服务亮点
- 官方折扣
- 按量计费
- 高速低延
Image link valid for 72 hours
MiniMax H3 Image API 价格
透明定价，无隐藏费用。按量付费，用多少付多少。
| 型号 | 规格 | 黄金价当前价格 | 铂金价 | 钻石价 | 官方价 | 为你节省 |
|---|---|---|---|---|---|---|
minimax-h3-image价格为预估价格，实际价格按 token 计费。 | 1K/2K | 0.1891Credits/张~$0.0189/张 | 0.1797Credits/张~$0.018/张 | 0.1702Credits/张~$0.017/张 | 0.2364Credits/张~$0.0236/张 | 20% |
| 4K | 0.628Credits/张~$0.0628/张 | 0.5966Credits/张~$0.0597/张 | 0.5652Credits/张~$0.0565/张 | 0.785Credits/张~$0.0785/张 | 20% |
* 实际费用以最终输出为准。
* 按 Token 计费。表中为单张文生图估算：图片输出加上提示词增强约 2,000 个文本输入 Token。参考图会另外产生图片输入 Token。每个任务的 cost 字段为实际扣费。
MiniMax H3 Image API：最高 4K 的文生图与图片编辑
用一句提示词生成图片，或传入最多 16 张参考图进行编辑。可选 1K、2K、4K 档位，宽高比在 1:3 到 3:1 之间任选，也可以直接指定像素，最大 2000 万像素。单次请求最多返回 10 张图片，内置的提示词增强会自动扩写简短的提示词。
MiniMax H3 Image API 调用示例：文生图与图片编辑
在 APIMart 上用一次 POST 请求调用 MiniMax H3 Image。生成是异步的：先提交任务，再轮询任务接口取得图片地址。
- 1
为 MiniMax H3 Image API 请求鉴权
把 APIMart Key 保存在环境变量 APIMART_API_KEY 中，每个请求都以 Authorization: Bearer <key> 发送。
- 2
提交 MiniMax H3 Image 任务
向 POST /v1/images/generations 发送请求，model 填 minimax-h3-image，并附上提示词、size 和 resolution。需要用参考图编辑时加上 image_urls。任务 ID 在 data[0].task_id。
- 3
获取生成的图片
每 3 到 5 秒轮询一次 GET /v1/tasks/{task_id}，status 为 completed 后从 data.result.images[0].url 读取图片地址。结果保留 72 小时，请及时下载。
全部参数、尺寸规则和响应字段见MiniMax H3 Image API 文档。
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "日落时分海边的一家温馨咖啡馆，照片级写实，暖色调",
"size": "16:9",
"resolution": "2K"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "minimax-h3-image",
"prompt": "日落时分海边的一家温馨咖啡馆，照片级写实，暖色调",
"size": "16:9",
"resolution": "2K"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-image",
"prompt": "把第二张图里的夹克穿到第一张图的人物身上，背景保持不变",
"image_urls": [
"https://example.com/person.jpg",
"https://example.com/jacket.png"
],
"resolution": "2K"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"MiniMax H3 Image API 参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | 默认值: minimax-h3-image | 填 minimax-h3-image。 |
prompt | string | 是 | 默认值: — | 图片描述，去除首尾空白后为 1 到 32,000 个字符。 |
size | string | 否 | 默认值: auto | auto、宽高比（如 16:9，范围 1:3 到 3:1）或像素（如 2048x1152，总像素 655,360 到 20,000,000）。 |
aspect_ratio | string | 否 | 默认值: — | 传宽高比的另一种写法，如 16:9。设置后会覆盖 size。 |
resolution | string | 否 | 默认值: 4K | 1K、2K 或 4K。size 为像素写法时不能使用。 |
n | integer | 否 | 默认值: 1 | 生成图片的数量，1 到 10。 |
image_urls | string[] | 否 | 默认值: — | 最多 16 张参考图，可以是 URL 或 Base64 data URI。传入后切换为编辑模式。 |
prompt_optimizer | boolean | 否 | 默认值: true | 在生成前扩写提示词。false 只对指定了明确尺寸的文生图生效。 |
output_format | string | 否 | 默认值: jpeg | jpeg、png 或 webp。 |
output_compression | integer | 否 | 默认值: 95 | 压缩质量，0 到 100。对 png 无效。 |
watermark | boolean | 否 | 默认值: false | 在图片上添加可见的 AI 生成水印。 |
