跳转到主要内容
POST
文生图
当前支持模型:MiniMax-H3-Image、MiniMax-H3-Image-Highspeed,两者参数与限制相同。
服务端最长等待 600 秒,建议客户端超时不低于 600 秒。本接口不支持幂等:请求发出后,即使客户端超时或断开连接,服务端仍会完成生成并对成功的图片计费;重试会重新生成并计费。使用 OpenAI SDK 时请设置 max_retries=0,关闭默认的自动重试。

授权

Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 账户管理>接口密钥 中查看。

请求体

application/json
model
enum<string>
必填

模型名称。可选值:MiniMax-H3-Image、MiniMax-H3-Image-Highspeed,两者参数与限制相同

可用选项:
MiniMax-H3-Image,
MiniMax-H3-Image-Highspeed
prompt
string
必填

图片的文本描述,最长 32000 个字符(按 Unicode 字符计,不含首尾空白),为空或只含空白时返回 400。关闭 Prompt 增强(disable_prompt_enhanced 为 true)时,模型只读取约前 4096 个 token,超出部分不生效。

Maximum string length: 32000
disable_prompt_enhanced
boolean
默认值:false

是否关闭 Prompt 增强,默认 false(开启增强),增强结果见 data[].revised_prompt。

设为 true 时直接使用原始 prompt,输出比例必须由请求给出,二选一:

  • size 为 宽x高
  • size 不传或为 auto,aspect_ratio 为 X:Y(area 可不传,默认 4K)

size 不是 宽x高、且 aspect_ratio 不传或为 auto 时返回 400。

n
integer
默认值:1

生成图片数量,取值范围 [1, 10],默认 1。

必填范围: 1 <= x <= 10
size
string
默认值:auto

输出图片尺寸,默认 auto,详见输出尺寸。两种写法二选一:

  • 宽x高:直接指定宽高,如 2720x1536,宽、高为正整数。面积(宽 × 高)在 655,360 ~ 20,000,000 像素之间,宽高比在 1:3 ~ 3:1 之间,均含边界;不满足时返回 400,不会自动缩放或取整。此时不能再传 aspect_ratio 或 area(传 auto 也不行),否则返回 400
  • auto 或不传:宽高由 aspect_ratio(默认 auto)和 area(默认 4K)决定,两者都可以单独传
aspect_ratio
string
默认值:auto

输出宽高比,默认 auto。

  • size 为 宽x高 时不能传入(传 auto 也不行),否则返回 400
  • size 不传或为 auto、且 disable_prompt_enhanced 为 true 时必须传 X:Y,不传或传 auto 返回 400

取值:

  • auto:由 Prompt 增强根据内容决定
  • X:Y:X、Y 为 1 ~ 300 的整数,宽高比在 1:3 ~ 3:1 之间(含边界),如 16:9、3:4、21:9、3:1
示例:

"16:9"

area
enum<string>
默认值:4K

输出面积档位,默认 4K。只能在 size 不传或为 auto 时传入,size 为 宽x高 时传入返回 400。

1K、2K、4K 的目标面积分别为 1024 × 1024、2048 × 2048、4096 × 4096 像素,宽高由服务端按宽高比计算,如 2K 搭配 16:9 输出 2720 × 1536。每张的实际宽高见 data[].size。

可用选项:
1K,
2K,
4K
output_format
enum<string>
默认值:jpeg

输出图片格式,默认 jpeg。可用值:png、jpeg、jpg、webp。jpg 与 jpeg 等价,响应中的 output_format 返回 jpeg。

可用选项:
png,
jpeg,
jpg,
webp
response_format
enum<string>
默认值:url

返回形式,默认 url。

  • url:图片链接,有效期 24 小时,请在有效期内下载并自行保存
  • b64_json:Base64 编码的图片数据,不支持流式

b64_json 的总输出面积(n × 宽 × 高)上限如下,超出返回 400(size 为 auto 时每张按 area 对应的面积计,如 4K 按 4096 × 4096):

可用选项:
url,
b64_json
stream
boolean
默认值:false

是否流式输出,默认 false。开启后响应为 text/event-stream(SSE),仅支持 response_format 为 url:

  • 每张图片处理完推送一个事件:成功为 image_generation.partial_succeeded,失败为 image_generation.partial_failed。事件按完成先后推送,用 image_index 对应张序
  • 全部结束后推送 image_generation.completed,包含 usage 和 request_id
  • 响应头返回后,全部图片失败或提交生成前失败时推送 error 事件
  • 响应头返回前的错误(参数错误、鉴权失败、限流、余额不足等)仍以普通 HTTP 错误返回,与非流式相同;请先检查 HTTP 状态码,再按 SSE 解析

事件结构见流式响应事件。

output_compression
integer
默认值:95

压缩质量,取值范围 [0, 100],默认 95,数值越大画质越高、文件越大。仅对 jpeg / webp 生效,输出 png 时忽略;超出取值范围返回 400。

必填范围: 0 <= x <= 100
aigc_watermark
boolean
默认值:false

是否在图片上添加可见的 AIGC 标识水印,默认 false。AIGC 隐式标识(写在图片文件的元数据中)按合规要求写入,不受该参数控制。

响应

stream 为 false(默认)时返回 application/json。stream 为 true 时返回 text/event-stream(SSE),每个事件的 data 为 JSON,结构见 text/event-stream 的响应定义,事件说明与完整示例见流式响应事件。

created
integer

响应生成时间,Unix 时间戳(秒)。

data
object[]

图片列表,始终为 n 项,按张序排列(与流式事件的 image_index 一致)。成功的项返回 url(或 b64_json)、size 和 revised_prompt;失败的项(包括未通过内容安全检查的)只返回 error。

只要有 1 张成功,HTTP 状态码就是 200,请逐项检查 data[].error;全部失败时返回 402、422 或 500 的错误响应。只对成功的图片计费。

output_format
enum<string>

生成图片的格式。

可用选项:
png,
jpeg,
webp
usage
object

本次请求的 token 用量,只统计成功的图片,按此计费。total_tokens 为 input_tokens 与 output_tokens 之和。

request_id
string

请求 ID(即 Trace ID),反馈问题时请提供。