
通过 MAI Image 2.7 API,你可以在 PoYo 上用一个 REST 接口调用微软 AI 最新的图像模型:mai-image-2.7 用于最终成品,mai-image-2.7-flash 用于更便宜、更快的任务。两者接受相同的请求体,既可以根据提示词生成,也可以编辑最多 5 张参考图,并能返回透明 PNG 或 WebP 文件。本文介绍 MAI Image 2.7 是什么、确切的限制、token 价格,以及我们在发布当天的实测结果。
MAI Image 2.7 是什么?
MAI Image 2.7 是微软 AI(MAI)的图像生成与编辑模型,于 2026 年 11 月 17 日与 MAI Image 2.7 Flash 一同发布。根据微软的模型卡,它是一个拥有 200 亿非嵌入参数的扩散模型,同时面向文生图和 "precise, controllable image-to-image editing",而 MAI Image 2.7 Flash 是 "an optimized version of MAI Image 2.7"。
微软表示该模型 "rebuilt from the ground up for multimodal editing workflows",并列出了物体移除、替换、属性修改、局部重绘、文字更新和瑕疵清理(如运动模糊)等编辑操作。微软还称,截至 2026 年 11 月 16 日,MAI Image 2.7 在 Artificial Analysis 的 AA-Image-Editing v2.1 排行榜上位列第一,在 5,478 票中获得 1,215 Elo。
对 API 集成来说,值得发给它的请求有三类:
- 必须保持画面其余部分不变的编辑:修改商品颜色、替换物体、改写招牌或标签。
- 画面中带文字的图像:微软的模型卡报告了 "improved rendering of text within generated images, including labels, posters, packaging, and signage"。
- 需要真实 alpha 通道的素材:微软表示两个模型都 "support transparent backgrounds",PoYo 将其提供为
background: "transparent"。
MAI Image 2.7 API 一览
| MAI Image 2.7 | MAI Image 2.7 Flash | |
|---|---|---|
| PoYo 模型 ID | mai-image-2.7 | mai-image-2.7-flash |
| 提交接口 | POST https://api.poyo.ai/api/generate/submit | 相同 |
| 获取结果 | 轮询 GET /api/generate/status/{task_id} 或使用 callback_url | 相同 |
| 输入模式 | 文生图;编辑 1 张图;合成 2 到 5 张图 | 相同 |
| 请求字段 | prompt、image_urls、size、resolution、background、output_format | 相同 |
| 微软发布日期 | 2026 年 11 月 17 日 | 2026 年 11 月 17 日 |
| 文档 | MAI Image 2.7 API 参考 | MAI Image 2.7 Flash 参考(schema 相同) |
两个 PoYo schema 只有模型 ID 不同,所以切换档位只需改一个字符串。各档位何时更划算,请看档位对比。
限制与请求字段
| 字段 | PoYo 上的规则 |
|---|---|
prompt | 必填,1 到 32,000 个字符,必须包含非空白文本。画面中要出现的确切文字请放在引号里。 |
image_urls | 可选,1 到 5 个公开 HTTP(S) URL 组成的数组,JPEG、PNG 或 WebP。一张图为编辑,多张图为合成。参考图最多按约 1 百万像素使用。 |
size | 1:1(默认)、4:3、3:4、3:2、2:3、16:9、9:16,或自定义 WIDTHxHEIGHT |
| 自定义尺寸 | 两边都能被 16 整除,每边至少 768,总像素不超过 4,194,304;按给定尺寸原样使用 |
resolution | 1K(默认,约 1 百万像素,1:1 为 1024x1024)或 2K(约 4 百万像素,16:9 为 2720x1536) |
background | opaque(默认)或 transparent;transparent 需要 png 或 webp |
output_format | png(默认)、jpeg、webp |
| 每次请求的图像数 | 1 |
有 image_urls 但没有 size 时,输出沿用第一张参考图的宽高比,约 1 百万像素。4,194,304 像素的上限与微软模型卡一致,模型卡给出了同样的 "maximum total pixel count",并说明只要总数在此范围内,任意一边都可以超过 2048。
MAI Image 2.7 API 价格
PoYo 按我们价目表中的费率对两个模型按 token 计费。1 积分 = $0.005。
| 每 100 万 token | PoYo 上的 MAI Image 2.7 | PoYo 上的 MAI Image 2.7 Flash |
|---|---|---|
| 文本输入 | 1,000 积分($5.00) | 350 积分($1.75) |
| 图像输入 | 1,600 积分($8.00) | 500 积分($2.50) |
| 图像输出 | 6,800 积分($34.00) | 2,000 积分($10.00) |
在 PoYo 上,输出 token 随像素数变化:约每 1,024 像素 1 个 token。一张 1024x1024 的图约为 1,024 个输出 token,在 MAI Image 2.7 上约 6.96 积分($0.035),在 Flash 上约 2.05 积分($0.0102),另加提示词文本 token 的少量费用。价格详解逐一计算了每种尺寸。
发布当天的实测
PoYo 团队于 2026 年 11 月 19 日在 PoYo 生产 API 上运行了以下请求。时间是客户端每隔几秒轮询所看到的从提交到出结果的时长,请视为近似值。
| 请求 | 输出 | 按现行费率的费用 | 时间 |
|---|---|---|---|
mai-image-2.7、16:9、2K、png,雨夜咖啡馆,霓虹招牌写着 "OPEN LATE" | 2720x1536 | 27.802 积分(约 $0.139) | 约 66 秒 |
mai-image-2.7-flash,相同请求 | 2720x1536 | 8.1803 积分(约 $0.041) | 约 42 秒 |
mai-image-2.7-flash、1:1、1K、background: transparent、png | 1024x1024 RGBA,背景完全透明 | 2.062 积分(约 $0.0103) | 约 42 秒 |
两次咖啡馆运行中,招牌都与提示词完全一致地显示为 "OPEN LATE"。透明运行返回的是真实的 alpha 通道,而不是白色或棋盘格背景;完整请求见透明背景指南。
你的第一个 MAI Image 2.7 API 请求
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"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"
}
}'
响应中包含 data.task_id,状态为 not_started。轮询状态接口直到变为 finished,然后从 data.files[0].file_url 读取图像;或者传入顶层 callback_url,在任务结束时接收 POST。务必检查响应体中的 code 字段:部分校验错误会以 HTTP 200 返回 code: 400。API 指南提供了带超时上限的 Python 轮询循环,以及每种输入模式的 JSON 请求体。
在哪里可以使用 MAI Image 2.7
微软以托管模型的形式提供 MAI Image 2.7,不提供可下载的权重。它在 Microsoft Foundry 上处于公开预览阶段,微软文档将 MAI-Image-2.7 和 MAI-Image-2.7-Flash(版本 2026-11-02)列为 Global Standard 部署;你也可以在 MAI Labs 中试用,微软称其面向个人、非商业用途。
在 PoYo 上,你用调用其他所有模型的同一个 API key 即可调用这两个模型,无需 Azure 订阅或部署步骤。PoYo 的请求格式也与 Foundry 不同:一个 JSON 接口通过 image_urls 处理编辑(Foundry 使用单独的 multipart 编辑接口),并且你选择的是宽高比加 1K/2K 或自定义尺寸,而不是原始的宽和高。
请求该路由到哪里
| 请求 | 调用的模型 |
|---|---|
| 最终主视觉图、精确编辑、文字密集的海报和包装 | mai-image-2.7 |
| 草稿、预览、缩略图、大批量商品图和贴纸任务 | mai-image-2.7-flash |
| 需要实时网络信息的提示词(时事、真实地点) | 带 enable_web_search 的 mai-image-2.6,见 MAI Image 2.6 |
MAI Image 2.7 不接受 MAI Image 2.6 的联网搜索选项。2.6 请求中的其他内容都可以沿用;2.7 与 2.6 对比列出了字段变化和迁移 diff。
常见问题
MAI Image 2.7 API 的模型 ID 是什么?
旗舰版用 mai-image-2.7,Flash 用 mai-image-2.7-flash。mai-image-2-7 只是 PoYo 的页面 slug,作为模型 ID 会被拒绝。
MAI Image 2.7 API 多少钱? 在 PoYo 上,MAI Image 2.7 的文本输入、图像输入和输出分别为每 100 万 token $5.00 / $8.00 / $34.00,Flash 为 $1.75 / $2.50 / $10.00。一张 1024x1024 的图在 MAI Image 2.7 上约 $0.035,在 Flash 上约 $0.0102。
MAI Image 2.7 API 能生成新图,还是只能编辑?
两者都可以。只有 prompt 的请求会生成新图。在 image_urls 中加入 1 到 5 个 URL,同一个请求就变成编辑或多图合成。
MAI Image 2.7 API 支持透明背景吗?
支持。发送 "background": "transparent" 并配合 "output_format": "png" 或 "webp"。我们发布当天的 Flash 测试返回了一张背景完全透明的 1024x1024 RGBA PNG。
MAI Image 2.7 API 能返回的最大图像是多少?
4,194,304 像素,例如 2048x2048 或自定义的 3072x1344。在 2K 下,16:9 返回 2720x1536。
一个 MAI Image 2.7 API 请求需要多长时间?
在 2026 年 11 月 19 日的测试中,一张 2K 16:9 图像在 MAI Image 2.7 上约需 66 秒,在 Flash 上约需 42 秒。请使用带截止时间的轮询或 callback_url,不要一直挂着请求等待。