curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mai-image-2.7",
"input": {
"prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
"size": "16:9",
"resolution": "2K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1794383400-abcd1234",
"status": "not_started",
"created_time": "2026-11-11T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Microsoft
MAI Image 2.7
微软 MAI Image 2.7 API 可根据提示词生成一张图像,也可以编辑一张参考图,或将最多 5 张参考图合成为一张。支持 1K 和 2K 输出、最高约 400 万像素的自定义尺寸、透明背景,以及 PNG、JPEG 或 WebP 输出。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "mai-image-2.7",
"input": {
"prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
"size": "16:9",
"resolution": "2K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1794383400-abcd1234",
"status": "not_started",
"created_time": "2026-11-11T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url,当任务状态变为finished或failed时,系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url,都可以通过统一的查询任务状态接口获取结果。
mai-image-2.7 根据提示词制作海报、产品图、Logo 等各类图像,也可以编辑和合成参考图。如果想要速度更快、成本更低且参数相同的选项,请使用 MAI Image 2.7 Flash。
模型
- mai-image-2.7 — 微软 MAI Image 2.7,支持文生图、图像编辑和多图合成
功能
- 根据最多 32,000 个字符的提示词生成图像。
- 编辑单张参考图,或将最多 5 张参考图合成为一张图像。
- 提供 7 种宽高比,可选
1K或2K,也支持最多 4,194,304 像素的自定义WIDTHxHEIGHT尺寸。 - PNG 和 WebP 输出支持透明背景。
- 支持 PNG、JPEG 或 WebP 输出。
输入模式
- 文生图 — 不传
image_urls。输出尺寸由size和resolution决定。 - 编辑 / 合成 — 在
image_urls中传入 1 到 5 个 URL。传一张图时编辑该图,传两张及以上时将它们合成为一张。不传size时,输出跟随第一张参考图的宽高比,约 100 万像素;传入size时按该尺寸输出。
必填参数
prompt(string):描述图像或所需编辑的提示词,1–32,000 个字符,必须包含非空白文本。需要原样出现在图上的文字,请用引号括起来。
可选参数
image_urls(array of strings):1 到 5 个可公开访问的 HTTP(S) 参考图 URL,格式为 JPEG、PNG 或 WebP。传入后进入编辑 / 合成模式。size(string):1:1、4:3、3:4、3:2、2:3、16:9、9:16或自定义WIDTHxHEIGHT。文生图默认为1:1。参见尺寸。resolution(string):1K或2K。默认为1K。用于宽高比尺寸。background(string):opaque或transparent。默认为opaque。transparent要求output_format为png或webp。output_format(string):png、jpeg或webp。默认为png。
尺寸
- 宽高比:
1:1、4:3、3:4、3:2、2:3、16:9、9:16。1K输出约 100 万像素(例如1:1为 1024×1024)。2K输出约 400 万像素(例如16:9为 2720×1536)。 - 自定义
WIDTHxHEIGHT尺寸要求宽和高都能被 16 整除,每边不小于 768,总像素数不超过 4,194,304(例如2048x2048或3072x1344)。自定义尺寸按填写的宽高原样输出,resolution用于宽高比尺寸。 - 编辑 / 合成模式下不传
size时,输出跟随第一张参考图的宽高比,约 100 万像素。
输出
- 每次请求返回一张图像,格式由
output_format决定(默认png)。 background设为transparent时,图像带 alpha 通道。请搭配output_formatpng或webp使用。
示例
文生图
{
"model": "mai-image-2.7",
"input": {
"prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
"size": "16:9",
"resolution": "2K"
}
}
图像编辑
{
"model": "mai-image-2.7",
"input": {
"prompt": "Change the bicycle to blue and add a small dog next to it",
"image_urls": [
"https://example.com/bicycle.png"
]
}
}
自定义尺寸
{
"model": "mai-image-2.7",
"input": {
"prompt": "A wide panoramic banner of a mountain range at sunrise",
"size": "3072x1344"
}
}
透明背景
{
"model": "mai-image-2.7",
"input": {
"prompt": "A flat vector logo of a red fox head, clean edges, no background",
"background": "transparent",
"output_format": "webp"
}
}
注意事项
- 每次请求返回一张图像。
image_urls必须是数组,即使只有一张图像。- 参考图按最大约 100 万像素使用。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。
在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。
200:成功400:请求参数无效401:API Key 缺失或无效402:积分不足403:没有权限404:资源不存在408:请求超时429:请求频率超限500:服务器内部错误502:上游服务错误503:服务暂不可用
详见错误码。
可用选项:
200, 400, 401, 402, 403, 404, 408, 429, 500, 502, 503 示例:
200