MiniMax H3 Image 上手指南：文生图、多图参考编辑、参数与价格

MiniMax H3 Image 是 MiniMax 的图像模型，在 HiAPI 上有两个调用 ID：minimax-h3-image/text-to-image（文生图）和 minimax-h3-image/image-to-image（带 1–16 张参考图生成或编辑）。这篇文章讲清楚两个 ID 怎么选、参数怎么填、怎么算钱，以及调用时要注意的细节。

两个 ID 怎么选

• 只有文字描述：用 text-to-image，必填只有 prompt（最多 5000 字符）。
• 手里有图要参考：用 image-to-image，额外必填 image_urls，1–16 张。可以按商品图换场景、把照片重绘成插画或油画风格，也可以同时给多张参考图。
• 两个 ID 出图价格相同，图生图按参考图张数另外加价，见下文「价格」。

参数

• resolution：1K / 2K / 4K，默认 2K。例如 2K 1:1 输出 2048×2048，1K 9:16 输出 768×1360，4K 16:9 输出 5472×3072。
• aspect_ratio：auto、1:1、5:4、4:5、4:3、3:4、3:2、2:3、16:9、9:16、21:9。文生图默认 1:1；图生图默认 auto，由模型根据提示词和参考图自己选比例，不一定跟第一张参考图一致——要固定画幅就明确填比例。
• output_format：jpeg（默认）或 png。PNG 体积大很多，4K PNG 可达 30MB，没有特别需要就用 jpeg。
• seed：可选，0–2147483647，想复现同一张图时固定它。
• 每次请求出 1 张图；不支持自定义宽高、透明背景和遮罩局部重绘。

调用示例

提交任务：

curl https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-image/image-to-image",
    "input": {
      "prompt": "Place the serum bottle on a pale stone pedestal, soft side light, clean e-commerce product shot",
      "image_urls": ["https://example.com/bottle.png"],
      "resolution": "2K",
      "aspect_ratio": "3:4"
    }
  }'

返回 data.taskId 后轮询 GET https://api.hiapi.ai/v1/tasks/<taskId>。status 变成 success 时，图片地址在 data.output[0].url。2K 图一般 30–40 秒出结果。结果链接有有效期（字段 expireAt），需要长期保存请自行下载转存。

价格

• 1K、2K：每张 $0.0129。
• 4K：每张 $0.0393。
• 图生图每张参考图加 $0.0036。例如 2K 带 3 张参考图：0.0129 + 3 × 0.0036 = $0.0237。
• 只对成功出图的任务扣费，任务失败全额退款。

提示词怎么写

• 按「主体 + 场景 + 光线 + 风格 + 构图」的顺序写清楚。
• 图生图里说清楚哪些要保留、哪些要改，例如「保留人物五官和姿态，背景换成暖灰色块，整体改成油画笔触」。
• 先用 1K 或 2K 试构图，定稿后再出 4K：4K 单价是 2K 的 3 倍左右。