创建图片

POST/v1/images/generations

根据文本提示生成图片。

Authorization

bearerAuth

AuthorizationBearer <token>

使用平台 API Key，格式为 Authorization: Bearer your-api-key。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

平台模型 ID。

prompt*string

生成或编辑图片的提示词，按 Unicode 字符计，不含首尾空白；内容不能全为空白。

Length1 <= length <= 32000

n?integer

生成图片数量。

Range1 <= value <= 10

Default1

size?string

auto 或宽x高，默认 auto。自定义面积为 655,360–20,000,000 像素，宽高比为 1:3–3:1；指定宽高时省略 aspect_ratio 和 area。

Default"auto"

aspect_ratio?string

默认 auto，由增强后的提示词决定；编辑时结合参考图。也可传 X:Y，X、Y 为 1–300 的整数，比值为 1:3–3:1。仅在 size 省略或为 auto 时使用。

area?string

面积档位，默认 4K。仅在 size 省略或为 auto 时使用，实际宽高见 data[].size。

Value in

"1K"
"2K"
"4K"

output_format?string

图片格式。jpg 与 jpeg 等价，响应统一返回 jpeg。

Default"jpeg"

Value in

"jpeg"
"jpg"
"png"
"webp"

response_format?string

url 链接有效期 24 小时；b64_json 返回 Base64 且不能流式。Base64 总输出面积上限为 PNG 20,000,000 像素、JPEG／WebP 80,000,000 像素，按张数合计。

Default"url"

Value in

"url"
"b64_json"

output_compression?integer

JPEG／WebP 压缩质量，数值越高文件越大；PNG 忽略此项。

Range0 <= value <= 100

Default95

stream?boolean

是否使用 SSE 逐张返回结果，仅支持 response_format 为 url。

Defaultfalse

aigc_watermark?boolean

是否添加可见 AIGC 水印，不影响文件元数据中的隐式标识。

Defaultfalse

disable_prompt_enhanced?boolean

是否关闭提示词增强。关闭后约前 4,096 个 Token 生效，必须指定具体 size 或固定 aspect_ratio。

Defaultfalse

Response Body

`application/json`

type*string

created?integer

事件的 Unix 时间戳。

model?string

实际使用的模型 ID。

image_index*integer

图片序号，从 0 开始。

Range0 <= value

url*string

生成图片的临时链接。

size?string

图片实际宽x高。

output_format?string

实际输出格式。

Value in

"jpeg"
"png"
"webp"

revised_prompt?string

该张图片使用的提示词。

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "生成一张木桌上的绿色台灯照片，背景是浅色墙面，光线柔和自然。",
    "size": "2048x2048",
    "n": 1,
    "response_format": "url"
  }'

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "浅色墙面前的木桌上摆放着一盏绿色台灯，柔和自然光照亮灯罩与桌面。"
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

客户端超时建议不低于 600 秒。请求超时或断开后，服务端可能继续生成；再次发送会创建新的请求。

MiniMax 创建图片 API查看请求参数与响应结构。

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

流式响应事件

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`