跳转到主要内容
POST

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

MAI Image 文生图与图生图的标准请求。

model
string
必填

必填。使用 Get Models 返回的模型 ID 或可用别名。

Minimum string length: 1
示例:

"microsoft/mai-image-2.5-pro"

prompt
string
必填

必填。图片提示词,原生模型上下文上限 32,000 tokens。

Minimum string length: 1
示例:

"一座漂浮在云海上的未来城市,日出时分,电影级光影,建筑细节丰富"

size
string
默认值:1024x1024

兼容尺寸 WIDTHxHEIGHT。MAI Image 2.5 Pro 的宽、高均至少 768,且总像素不超过 1,048,576。

Pattern: ^[1-9][0-9]*x[1-9][0-9]*$
response_format
enum<string>
默认值:url

返回形式:url 返回图片地址,b64_json 返回图片 Base64。

可用选项:
b64_json,
url
images
(string | object)[]

可选。单张图生图参考图,支持 JPEG 或 PNG;省略时为文生图。

Required array length: 1 element
Minimum string length: 1

响应

200 - application/json

统一转换后的 OpenAI Images 响应。

created
integer
必填

图片创建时间的 Unix 时间戳,单位为秒。

示例:

1788480000

data
object[]
必填

生成结果列表。

model
string
必填

实际执行请求的模型标识。

output_format
string
必填

实际输出格式。

size
string
必填

实际生成尺寸。

usage
object
必填

本次生成的用量信息。