MAI Image 2.7 Edit API

microsoft/mai-image-2.7/edit
image_urls · 1–5

MAI Image 2.7 Edit API 按文字指令修改物体、颜色、光线和图中文字,照片其余部分保持原样,还能把最多 5 张参考图合成为一个画面。Microsoft 的 MAI Image 2.7 在预览阶段位列 Artificial Analysis 图片编辑榜第 2 名。

获取 API Key
Input
必填269/32000
必填
Image Urls

拖拽文件、粘贴剪贴板素材,或输入 URL。 按提示词中的顺序提供 1–5 个公开的 HTTP(S) JPEG、PNG 或 WebP 图片地址。每张图会缩放到约 100 万像素,最多计 1,024 个图片输入 Token。

1/5 个素材

可选
可选
可选
可选
Output已就绪

最高预扣: 9.1048 credits · $0.04552

按实际 Token 计费,1K 方图约 7.0 积分,完成后返还差额。

继续使用

示例

output-23b3681ddffc.png

On the menu board, change "Bulgogi Taco $4" to "Bulgogi Taco $5" and replace the line "Gochujang Wings $9" with "Spicy Pork Bowl $11". Keep the title "SEOUL & SALSA", the brush lettering style, the chili icon, the truck paint and the lighting unchanged.

output-fe0d7c06e0f3.png

Place the tailor from image 1 at the street corner from image 3, standing in front of the blue door and smiling, wearing a tailored single-breasted jacket sewn from the wax-print fabric in image 2 over his white T-shirt, with the yellow measuring tape still around his neck. Match the warm afternoon light and shadows of image 3. Photorealistic, full body from the knees up.

MAI Image 2.7 Edit API 是什么?

MAI Image 2.7 最早以编辑模型亮相:Microsoft AI 于 2026 年 10 月 27 日发布预览版,在 Artificial Analysis 图片编辑榜上取得 1,193 Elo、排名第 2,11 月 17 日正式发布。Microsoft 表示,在该评测的 10 类用例和 7 种编辑操作上,它都比 MAI Image 2.6 有所提升,涵盖物体和颜色修改、文字更新与瑕疵清理。MAI Image 2.7 Edit API 的编辑端点接收 1–5 张参考图和一条指令,返回 1 张图。

为什么选择 MAI Image 2.7 Edit API?

MAI Image 2.7 Edit API 只改指令里点名的部分,照片其余内容保持原样,一次可处理 1–5 张参考图。

  • 只改指定部分只修改一个元素,例如给干涸的喷泉注满水,MAI Image 2.7 Edit API 会保留原图的瓷砖、植物和光线。

  • 更新图中文字写出新旧文字,就能以相同字体风格更新价格、菜单和招牌,参考餐车菜单示例。

  • 最多 5 张参考图合成把人物、面料和街景合成一张图;达喀尔裁缝示例用 3 张参考图生成 1K 结果。

  • 编辑能力位居前列预览阶段,MAI Image 2.7 在 Artificial Analysis 图片编辑榜取得 1,193 Elo,排名第 2。

  • 输出尺寸可控size 留空时跟随第 1 张图(约 100 万像素),也可设定比例、2K 或精确的 WIDTHxHEIGHT。

  • 按次编辑按 Token 计费每张参考图最多计 1,024 个图片输入 Token,MAI Image 2.7 Edit API 单图 1K 编辑约 8.6 积分。

MAI Image 2.7 Edit API 支持哪些参数?

本接口必填 prompt 和 image_urls(1–5 张图),size、resolution、background、output_format 控制输出。

参数要求说明
prompt必填

编辑指令,最多 32,000 个字符。写明改什么、保留什么,用“图 1”“图 2”指代参考图。

image_urls必填

1–5 个公开的 JPEG、PNG 或 WebP 图片地址。1 张时编辑该图,多张时按顺序合成。

size可选

留空时跟随第 1 张图,约 100 万像素。比例:1:1、4:3、3:4、3:2、2:3、16:9、9:16,或自定义 WIDTHxHEIGHT(两边为 16 的倍数、每边至少 768、总像素不超过 4,194,304),按给定尺寸输出。

resolution可选

比例尺寸时可选 1K 或 2K。1K 约 100 万像素(1:1 为 1024×1024),2K 约 400 万像素(16:9 为 2720×1536)。

默认值1K2K
background可选

opaque 或 transparent。transparent 搭配 png 或 webp 输出带 Alpha 通道的图片。

默认值opaquetransparent
output_format可选

png、jpeg 或 webp。

默认值pngjpegwebp

如何调用 MAI Image 2.7 Edit API?

调用步骤:上传 1–5 张图,写清改什么、保留什么,任务 finished 后读取图片地址。

  1. 添加参考图按指令中提到的顺序上传或粘贴 1–5 个公开的 JPEG、PNG 或 WebP 地址。

  2. 写编辑指令写明改什么、保留什么,例如“瓷砖和光线保持原样”,要替换的文字放进引号。

  3. 选择输出尺寸留空跟随第 1 张图,或选择比例搭配 1K、2K,或自定义 WIDTHxHEIGHT。

  4. 选择背景和格式抠出主体用 transparent 搭配 png 或 webp,照片用 jpeg。

  5. 运行并获取结果提交 MAI Image 2.7 Edit API 编辑任务,状态为 finished 后读取图片地址。

MAI Image 2.7 Edit API 多少钱?

MAI Image 2.7 Edit API 按实际 Token 计费:文本输入每百万 1,000 积分,图片输入每百万 1,600 积分,图片输出每百万 6,800 积分;1 积分 = $0.005。

输出 Token = 宽 × 高 ÷ 1024,1K 方图约 7.0 积分($0.035),2K 方图约 27.9 积分($0.14)。提交时 MAI Image 2.7 Edit API 按上限预扣:提示词按 UTF-8 字节数 ÷ 4 计,每张参考图按 1,024 Token 计,1K 尺寸或未指定尺寸的编辑按 1,088 个输出 Token,2K 按 4,096 个,自定义尺寸按实际像素。完成后按实际 Token 结算,差额退回余额;失败任务全额退回。

MAI Image 2.7 Edit API 多少钱?
计费项积分 / 百万 Token美元 / 百万 Token
文本输入1,000$5.00
图片输入1,600$8.00
图片输出6,800$34.00

MAI Image 2.7 Edit API 适合哪些场景?

适合商品和室内改图、菜单招牌本地化、多图合成场景和照片清理。

  • 商品与空间改稿根据一张照片换颜色、换材质或重新布置房间,版式和透视保持一致。

  • 菜单与招牌本地化在看板、包装和海报上更新价格、优惠和语言,字体风格保持一致。

  • 合成活动主视觉把分开拍摄的模特、商品、图案和场景合成为一张图。

  • 清理与增强Microsoft 将画质增强和瑕疵清理列为 MAI Image 2.7 的编辑操作,可用于修复已有照片。

使用技巧

  • 写出要保留的内容,例如版式、人物面部、光线和背景。
  • 新旧文字都原样写出,例如把 "Bulgogi Taco $4" 改成 "Bulgogi Taco $5"。
  • 按 image_urls 的顺序用“图 1”“图 2”“图 3”指代参考图。
  • 合成图时设定 size,例如全身人像用 3:4,让画面更合适。

注意事项

  • image_urls 接收 1–5 个公开的 JPEG、PNG 或 WebP 地址,生成前每张缩放到约 100 万像素。
  • MAI Image 2.7 Edit API 每次请求返回 1 张图,prompt 最多 32,000 个字符。
  • 未指定 size 时跟随第 1 张图,约 100 万像素;resolution 在比例尺寸时生效。
  • 任务异步执行:提交后返回 task_id,也可通过 callback_url 接收完成结果。

参考来源

本页的模型信息来自 Microsoft AI 官方发布(引文为中文译文):

“MAI Image 2.7 是我们最新的图像编辑模型,在最难做好的编辑上提供了更强的控制力。”

— Microsoft AI, MAI Image 2.7 debuts above GPT Image 2.5 Flare on Artificial Analysis and #3 on Arena,

“专为高质量图像生成和精准、可控的编辑而打造。”

— Microsoft AI, MAI Image 2.7 | Microsoft AI

MAI Image 2.7 Edit API 常见问题

MAI Image 2.7 Edit API 是什么?

MAI Image 2.7 Edit API 是 MAI Image 2.7 的编辑端点。MAI Image 2.7 是 Microsoft AI 于 2026 年 11 月 17 日发布的图像模型。它接收 1–5 张参考图和一条文字指令,修改物体、颜色、光线或图中文字并保留其余内容,也能把多张参考图合成为一个画面。你可以通过 API 调用,也可以在上方体验区直接试用。

MAI Image 2.7 Edit API 最多可以传几张图?

image_urls 可传 1–5 个公开的 JPEG、PNG 或 WebP 地址。1 张时编辑该图,多张时合成,用“图 1”“图 2”依次指代。生成前每张缩放到约 100 万像素。

MAI Image 2.7 Edit API 能修改图片里的文字吗?

可以。写出原文字和新文字,并说明要保留的内容,例如字体风格。Microsoft 将文字更新列为 MAI Image 2.7 的编辑操作之一,本页的菜单示例用原有的手写字体更新了两行内容。

MAI Image 2.7 Edit API 编辑后输出多大尺寸?

size 留空时,输出跟随第 1 张图的比例,约 100 万像素。需要固定画幅时,可设定比例搭配 1K 或 2K,或自定义 WIDTHxHEIGHT(两边为 16 的倍数、每边至少 768、总像素不超过 4,194,304)。

编辑用 MAI Image 2.7 还是 MAI Image 2.7 Flash?

两者字段相同。MAI Image 2.7 Flash 的输出 Token 单价约为三分之一,适合预览和批量编辑;MAI Image 2.7 Edit API 适合对细节要求最高的定稿编辑。