guides

MAI Image 2.7 API:MAI Image 2.7 是什么、价格、限制与 Flash

Poyo.ai Team
4 min read
Share:

PoYo 上的 MAI Image 2.7 API

通过 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.7MAI Image 2.7 Flash
PoYo 模型 IDmai-image-2.7mai-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 百万像素使用。
size1:1(默认)、4:3、3:4、3:2、2:3、16:9、9:16,或自定义 WIDTHxHEIGHT
自定义尺寸两边都能被 16 整除,每边至少 768,总像素不超过 4,194,304;按给定尺寸原样使用
resolution1K(默认,约 1 百万像素,1:1 为 1024x1024)或 2K(约 4 百万像素,16:9 为 2720x1536)
backgroundopaque(默认)或 transparent;transparent 需要 png 或 webp
output_formatpng(默认)、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 万 tokenPoYo 上的 MAI Image 2.7PoYo 上的 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"2720x153627.802 积分(约 $0.139)约 66 秒
mai-image-2.7-flash,相同请求2720x15368.1803 积分(约 $0.041)约 42 秒
mai-image-2.7-flash、1:1、1K、background: transparent、png1024x1024 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,不要一直挂着请求等待。

Share: