跳转到主要内容
MiniMax-H3-Image 支持文生图与图片编辑,输出面积最大 20,000,000 像素,可自定义宽高,或按宽高比与面积档位生成。 两个接口均为同步接口,开启 stream 后逐张推送结果。 高速版 MiniMax-H3-Image-Highspeed 的参数与限制与 MiniMax-H3-Image 相同,将请求中的 model 改为 MiniMax-H3-Image-Highspeed 即可使用。

模型规格

输出尺寸

输出尺寸有两种指定方式,二选一:size 传 宽x高 时,再传 aspect_ratio 或 area 会返回 400。
size 不传或传 auto 时按这种方式生成,aspect_ratio 和 area 都可以单独传,每张的实际宽高见 data[].size。
  • aspect_ratio:默认 auto,由 Prompt 增强根据内容决定;也可指定 X:Y,X、Y 为 1 ~ 300 的整数,宽高比在 1:3 ~ 3:1 之间(含边界),如 16:9、3:4、21:9
  • area:1K、2K、4K(默认),目标面积分别为 1024 × 1024、2048 × 2048、4096 × 4096 像素,宽高由服务端按宽高比计算,如 2K 搭配 16:9 输出 2720 × 1536
文生图设置 disable_prompt_enhanced: true 时,必须用 size 指定宽高,或用 aspect_ratio 指定 X:Y,否则返回 400。

文生图

图片编辑

参考图通过 images[].image_url 传入,支持公网 URL、mm_file://{file_id}(引用已上传文件,file_id 通过文件上传接口以 purpose 为 image_generation_input 上传获得)或 data:image/<格式>;base64,<Base64> data URI。也可以用 OpenAI SDK 的 images.edit 直接上传图片文件(multipart/form-data,上传顺序即 Picture 编号),见下方示例。 参考图限制(请求体总大小 ≤ 64 MiB,Base64 编码后的大小约为原文件的 4/3;超过该上限时请改用公网 URL 或 mm_file://)

Prompt 增强

文生图默认开启 prompt 增强,可通过 disable_prompt_enhanced: true 关闭,此时需指定宽高或固定的 aspect_ratio;图片编辑始终开启 prompt 增强。每张图实际使用的 prompt 见 data[].revised_prompt。 如需精细调整,可修改 revised_prompt 后作为文生图新请求的 prompt,并设置 disable_prompt_enhanced: true。 也可以调用H3-Image-Context-IR接口单独获取增强结果,不生成图片,该接口仅支持 MiniMax-H3-Image。

部分失败

只要有一张图片生成成功,请求即返回 200。data 共 n 项,失败或未通过内容安全检查的项只返回 error,成功张数见 usage.generated_images:
全部失败时返回错误响应,并附带每张的 data 与 usage。全部因内容安全检查失败返回 422,全部因余额不足失败返回 402,否则返回 500。

流式输出

设置 stream: true 后,每张图片完成即通过 SSE 推送,仅支持 response_format: "url"。推送顺序为完成顺序,请用 image_index 区分。 前缀:文生图为 image_generation,图片编辑为 image_edit。字段详见流式响应事件。

推荐阅读

MiniMax-H3-Image 文生图接口

使用 MiniMax-H3-Image,输入文本描述,进行图片生成。

MiniMax-H3-Image 图片编辑接口

使用 MiniMax-H3-Image,输入参考图与文本描述,生成新图片。

流式响应事件

开启 stream 后推送的 SSE 事件类型与字段说明。

产品定价

各模型的定价说明、计费方式及使用限制。

速率限制

为保证资源的高效使用,引入速率限制,以确保服务的可用性、稳定性。