
MAI Image 2.7 API 可以返回带有真实 alpha 通道的图像,因此商品抠图、logo、图标和贴纸生成后无需任何蒙版处理,就能直接放到任意背景上。在 PoYo 上,只需 background 和 output_format 两个字段,mai-image-2.7 和 mai-image-2.7-flash 均可使用。在我们发布当天的测试中,Flash 上一张 1024x1024 的透明 PNG 按现行费率为 2.062 积分,约 $0.0103。接入代码之前,可以先在 MAI Image 2.7 模型页面上试一试。
微软对透明背景的说法
微软的发布文章称 "both models support transparent backgrounds for ready-to-use product images",并把 logo、图标和插画列为更多用途。微软的 Foundry 文档将透明背景列为 MAI-Image-2.7 相对早期 MAI 图像模型新增的能力,"for assets such as product imagery, logos, icons, and design elements that need to be placed over other content"。MAI Image 2.6 没有这个选项。
两个字段
| 字段 | 取值 | 默认值 | 规则 |
|---|---|---|---|
background | opaque、transparent | opaque | transparent 返回带 alpha 通道的图像 |
output_format | png、jpeg、webp | png | transparent 需要 png 或 webp |
由于默认值是 opaque 和 png,要得到透明效果必须显式发送 background。如果要 PNG,output_format 可以省略,但发送它能让日志中的意图更清楚。"background": "transparent" 搭配 "output_format": "jpeg" 是无效的,因为 JPEG 没有 alpha 通道;请在你这边校验这个组合,让它在提交前就失败。
其他字段照常工作:size(默认 1:1,可用任意预设比例,或最高 4,194,304 像素的自定义 WIDTHxHEIGHT)、resolution(1K 或 2K),以及可选的 callback_url。完整字段规则见 API 参考。
请求体
用 MAI Image 2.7 API 生成透明 PNG
在 Flash 上生成一张 1K 正方形贴纸,字段设置与我们实测的那次运行相同(提示词为示例):
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-flash",
"input": {
"prompt": "A cute cartoon sticker of a smiling coffee cup with a thick white outline, centered, no background",
"size": "1:1",
"resolution": "1K",
"background": "transparent",
"output_format": "png"
}
}'
透明 WebP logo
PoYo 文档中的示例,使用旗舰版:
{
"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"
}
}
WebP 同样支持 alpha,而且文件通常比 PNG 小,适合网页使用。对于印刷流程和默认使用 PNG 的设计工具,PNG 是更稳妥的选择。
两个请求都会返回 task_id。轮询 GET https://api.poyo.ai/api/generate/status/{task_id} 直到 status 为 finished,然后下载 data.files[0].file_url。完整的轮询循环见 MAI Image 2.7 API 指南。
实测:发布当天的透明贴纸
PoYo 团队于 2026 年 11 月 19 日在 PoYo 生产 API 上运行:
| 设置 | 值 |
|---|---|
| 模型 | mai-image-2.7-flash |
| 字段 | size: "1:1"、resolution: "1K"、background: "transparent"、output_format: "png" |
| 输出 | 1024x1024 PNG,RGBA |
| 背景 | 真实 alpha:主体周围完全透明 |
| 按现行费率的费用 | 2.062 积分(约 $0.0103) |
| 时间 | 约 42 秒,每隔几秒轮询,从提交到出结果 |
推算:1024x1024 约为 1,024 个输出 token,按每 100 万 2,000 积分计为 2.048 积分;剩下的 0.014 积分约等于按每 100 万 350 积分计的 40 个提示词 token。换句话说,透明图像和同尺寸的其他图像计费方式相同。价目表中没有透明附加费。
在代码中检查 alpha 通道
不要相信文件扩展名:在图像进入素材库之前,确认下载的图像确实有透明像素。使用 Pillow:
import io
import requests
from PIL import Image
def check_transparency(file_url):
data = requests.get(file_url, timeout=60).content
img = Image.open(io.BytesIO(data))
if img.mode != "RGBA":
img = img.convert("RGBA")
alpha = img.getchannel("A")
lo, hi = alpha.getextrema()
clear = sum(1 for a in alpha.getdata() if a == 0)
share = clear / (img.width * img.height)
print(img.size, img.mode, "alpha range", (lo, hi), f"{share:.0%} fully transparent")
return lo == 0 and share > 0.05
结果为 lo == 0 且完全透明像素占相当比例,说明这是可用的抠图。如果是一张画着棋盘格的图,结果会是 lo == 255,每个像素都不透明。阈值请根据你自己的素材来定:铺满画面的插画留白会比居中的图标少。
写出干净抠图的提示词
alpha 通道由模型处理,但主体是否容易分离仍然取决于提示词。
- 说明主体是单独的。 PoYo 文档示例以 "clean edges, no background" 结尾。微软 Foundry 的透明图像示例使用 "full body, centered, no shadow"。
- 避免场景词。 "On a table"、"in a studio" 或 "with a shadow" 会要求主体之外的东西。
- 贴纸要加描边。 粗白边在浅色和深色背景上都很清晰。
- 文字要加引号。 如果素材包含单词或 logo 文字,请像文档对画面文字的建议那样把它放在引号中。
批量生成透明素材的成本
输出 token 只取决于像素数,所以透明与不透明输出的成本相同。每张图的输出 token 费用:
| 尺寸 | MAI Image 2.7 | MAI Image 2.7 Flash |
|---|---|---|
1024x1024(1:1,1K) | 6.96 积分($0.0348) | 2.05 积分($0.0102) |
2048x2048(1:1,2K) | 27.85 积分($0.1393) | 8.19 积分($0.0410) |
按每张 Flash 贴纸实测 2.062 积分计算,1,000 张约 2,062 积分,大约 $10.31。图标集和商品抠图用 Flash;当单个素材(例如品牌 logo 或主视觉商品图)必须做到最好时,用 MAI Image 2.7。价格文章和 Flash 与 2.7 对比有更深入的介绍。
常见透明素材任务的设置
| 任务 | 模型 | size / resolution | output_format |
|---|---|---|---|
| 批量生成聊天或应用贴纸 | mai-image-2.7-flash | 1:1,1K | png 或 webp |
| 网站图标和插画 | mai-image-2.7-flash | 1:1,1K | webp |
| 电商商品抠图 | mai-image-2.7 | 1:1 或 3:4,2K | png |
| 用于印刷和幻灯片的品牌 logo | mai-image-2.7 | 1:1,2K | png |
| 叠加在主视觉上的宽幅横幅元素 | mai-image-2.7 | 自定义,例如 3072x1344 | webp |
这些只是起点,不是规则:每一行都只用了文档中的字段,所以你可以在不改动请求其他部分的情况下,把任务换到另一个档位或尺寸。每种新任务类型的第一批结果,请运行 alpha 检查。
以透明结果进行编辑
schema 也允许 background: "transparent" 与 image_urls 一起使用,例如把商品照片变成抠图,或在保留 alpha 通道的同时为现有贴纸换风格。我们还没有实测这种组合,所以在生产中依赖它之前,请先用你自己的几张图测试,并运行上面的 alpha 检查。
常见问题
如何用 MAI Image 2.7 API 获得透明背景?
在 input 中发送 "background": "transparent" 和 "output_format": "png"(或 "webp")。默认是不透明 PNG。
MAI Image 2.7 API 能返回透明 JPEG 吗?
不能。JPEG 没有 alpha 通道,所以 transparent 需要 PNG 或 WebP。
MAI Image 2.7 Flash 支持透明背景吗?
支持。我们在 mai-image-2.7-flash 上的发布日测试返回了一张背景完全透明的 1024x1024 RGBA PNG,按现行费率为 2.062 积分。
在 MAI Image 2.7 API 中透明背景会更贵吗? 不会。它与同尺寸的其他图像一样,按相同的文本、图像输入和输出 token 费率计费。
MAI Image 2.6 能生成透明 PNG 吗? 不能。透明是 MAI Image 2.7 的新功能。其他字段变化请看 MAI Image 2.7 API vs MAI Image 2.6 API。