MiniMax H3-Image参考图编辑怎么配置输入与输出尺寸

MiniMax H3-Image怎样用多张参考图编辑画面？把参考素材放进images数组，向/v1/images/edits提交清楚说明各图用途的prompt，并为输出选择一种尺寸配置即可。它一次接受1至16张参考图，编辑始终启用提示词增强；遮罩局部编辑和透明背景目前不受支持，接入前应先确认任务是否适合。

先把创作任务拆成素材角色

参考图编辑适合已有素材、希望在描述中组合或调整内容的任务。准备两张图时，可以把第一张定义为背景，第二张定义为要替换进去的主体，再写明保留哪些内容。官方示例就采用“把图1中的猫换成图2中的柴犬，背景保持不变”的表达方式。输入顺序与提示词里的图号要对应，避免只写“参考这些图生成”。

最多16张是输入能力上限，不代表每个角色、材质与细节都会准确保留。先用少量素材评估结果，再扩大输入数量，通常比一次塞满更容易定位描述问题。这是任务组织建议，并非模型效果保证。

检查参考图能否被接口接收

参考素材可通过images[].image_url传入：支持公开图片URL、mm_file://文件引用，以及data:image格式的Base64数据URI。使用文件引用时，先通过文件上传接口，以image_generation_input为purpose获得文件ID。公开URL则必须能被服务正常获取，不能直接填写自己电脑上的文件路径。

输入格式支持JPG、JPEG、PNG、WebP、HEIC和HEIF。每张图不超过64 MiB，宽和高各在128至8192像素之间，长短边比不超过4:1；参考图数量为1至16张。整个请求体同样不能超过64 MiB，因此不能把“单张64 MiB”理解为16张都可满额放入一个请求。

Base64编码后的体积约为原文件的4/3，素材较大时宜使用公开URL或文件引用。先检查输入尺寸、格式和实际请求体，再排查模型生成问题，可避免把输入限制误认为效果不佳。

按实际素材替换编辑请求参数

有API权限和余额后，在服务端向https://api.minimax.io/v1/images/edits发送POST，以Authorization: Bearer携带自己的API Key，使用JSON请求体。下面的example.com地址是占位示例，调用前必须替换为真实可访问的素材地址；密钥应保留在服务端配置中，不放进网页脚本或公开仓库。

{
  "model": "MiniMax-H3-Image",
  "prompt": "将图1中的猫替换为图2中的柴犬，保持图1的背景不变",
  "images": [
    {"image_url": "https://example.com/cat.jpg"},
    {"image_url": "https://example.com/dog.png"}
  ],
  "aspect_ratio": "16:9",
  "area": "2K",
  "n": 1,
  "response_format": "url"
}

标准模型为MiniMax-H3-Image，高速版为MiniMax-H3-Image-Highspeed，两者参数与限制相同。没有参考素材的纯文生图，应改用/v1/images/generations，仅提供提示词及相应配置。

参考图比例与输出比例要分开检查

输入图允许的长短边比不超过4:1，输出画幅却限制在1:3至3:1之间，不能把输入条件直接套给输出。示例使用16:9和2K面积档，官方给出的对应输出是2720×1536。换为4K时是5472×3072；正方形4K才是4096×4096。

area可选1K、2K、4K，实际尺寸以结果中的size为准。若要固定像素尺寸，可把比例与面积档删除，改用size，例如2720x1536。自定义面积必须在655360至20000000像素之间，比例在1:3至3:1之间，均包含边界；不合规则返回400，服务不会自动缩放或取整。

size指定固定宽高时，不得再同时传aspect_ratio或area。编辑始终开启提示词增强，可以查看每张图的revised_prompt理解实际采用的描述。只有文生图允许用disable_prompt_enhanced关闭增强，关闭后还要明确固定宽高或比例。

用返回结果判断任务是否完成

一次请求可生成1至10张图片，默认1张，输出支持JPEG、PNG、WebP。至少一张成功就可能返回HTTP 200，应用仍要逐项判断data里的结果或error，并读取usage.generated_images。全部失败时，内容安全检查、余额不足和其他错误分别可能返回422、402和500，不能把HTTP成功等同于每张图片成功。

如果应用需要逐张显示进度，可开启stream，以URL格式接收结果。事件按完成顺序到达，应使用image_index关联图片，不能按收到的先后直接填入固定序号。结果成功后自行下载保存；生成请求不是幂等操作，超时后盲目重发可能重复生成与收费。使用OpenAI SDK时，官方示例明确设置max_retries=0。

哪些需求应先换方案或检查授权

当前接口不支持预览图、遮罩编辑和透明背景。若任务依赖透明素材输出，不能因为存在编辑接口就假定它能完成。官方披露的4K速度是厂商测试结果，实际使用不应承诺所有请求都在相同时间内返回。

也可通过MiniMax API Platform、MiniMax Code或Hailuo AI使用服务。首发周五折仅针对4K及以上生成请求，实际结算以入口当前规则为准。计划下载开放权重自行运行时，还要检查社区许可证：适用地域排除欧盟、英国、韩国和美国；使用方及关联方年化收入超过100万美元，或向第三方提供托管服务，需要事先取得单独书面授权。托管调用与权重使用涉及不同规则，应按自己的实际方式分别核对。