MiniMax H3 Image 图像生成

图像生成模型名称，官方通道，稳定性和可控性更好，适用于商业场景

提示词，描述想要生成的图像，或描述如何编辑已输入的图像

长度限制：

• 最多 32,000 字符（按 Unicode 码点统计）
• prompt_extend 为 false 时，只有提示词的前约 4096 个 token 生效

生成图像的尺寸，支持比例格式与显式像素格式两种写法，默认 auto

① 比例格式（推荐）：X:Y，常用比例如下：

• 1:1：正方形
• 1:2 / 2:1：极竖/极横
• 1:3 / 3:1：超竖/超横（临界 3:1）
• 2:3 / 3:2：标准竖/横
• 3:4 / 4:3：传统竖/横
• 4:5 / 5:4：社交媒体常用
• 9:16 / 16:9：手机/桌面宽屏
• 9:21 / 21:9：超宽屏

其他 X:Y 也可以：X、Y 为 1 ~ 300 的整数，且长宽比 ≤ 3:1

② 显式像素格式：WxH（或 W×H），例如 1024x1024、2720x1536、5472x3072

• 像素预算：655,360 ≤ width × height ≤ 20,000,000（约 0.65 MP ~ 20 MP）
• 长宽比：≤ 3:1

③ auto：由模型自动决定画面比例，输出面积仍按 resolution 档位

超限处理：

• 超出上述范围的尺寸直接返回 400，不会自动缩放或取整

分辨率档位快捷参数，在 size 为 auto 或比例格式时生效，显式像素格式下此字段被忽略

像素预算规则（根据目标总像素数和 size 比例推算宽高）：

• 1K：~1 MP（1024² = 1,048,576 像素）
• 2K：~4 MP（2048² = 4,194,304 像素）
• 4K：~16.8 MP（4096² = 16,777,216 像素）

横版/正方形对应实际输出尺寸（竖版尺寸为对应横版的宽高调换，例如 3:4 = 4:3 反转）：

注意：

• 1K 与 2K 的图像输出 token 数相同（每张约 4,096）；4K 每张约 16,384，以返回的 usage 为准
• 取值大小写不敏感

输出图像的文件格式，默认 jpeg

• jpeg：有损压缩，文件体积更小
• png：无损
• webp：体积与质量兼顾

注意：

• 不支持透明背景

生成图片数量，每张独立计费

注意：

• 文本输入 token 与图像输入 token 都会随 n 等比放大
• 部分图片失败时（例如未通过内容安全审核），任务仍会带着成功的图片完成。实际张数以响应中的 results 为准，计费按返回的 usage 结算

提示词优化开关：生成前由模型把提示词改写得更详细，默认 true

注意：

• 只有文生图且 size 为比例格式或显式像素格式时可以设为 false
• size 为 auto，或传了 image_urls 时，设为 false 会返回 400
• 开启时每张图约增加 2,300 ~ 3,800 个文本输入 token；关闭时只计提示词本身

任务完成后的HTTPS回调地址

回调时机：

• 任务完成（completed）、失败（failed）或取消（cancelled）时触发
• 在计费确认完成后发送

安全限制：

• 仅支持HTTPS协议
• 禁止回调到内网IP地址（127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x等）
• URL长度不超过2048字符

回调机制：

• 超时时间：10秒
• 失败后最多重试3次（会分别在失败的1秒/2秒/4秒后进行重试）
• 回调响应体格式与任务查询接口返回的格式一致
• 回调地址若返回2xx状态码视为成功，其他状态码会触发重试

任务创建时间戳

任务ID

实际使用的模型名称

任务的具体类型

任务进度百分比 (0-100)

任务状态

任务的输出类型