how-tos

MAI Image 2.7 API 透明背景:生成 PNG 与 WebP 素材

Poyo.ai Team
4 min read
Share:

用 MAI Image 2.7 API 生成的透明 PNG 和 WebP 素材

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 没有这个选项。

两个字段

字段取值默认值规则
backgroundopaque、transparentopaquetransparent 返回带 alpha 通道的图像
output_formatpng、jpeg、webppngtransparent 需要 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.7MAI 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 / resolutionoutput_format
批量生成聊天或应用贴纸mai-image-2.7-flash1:1,1Kpng 或 webp
网站图标和插画mai-image-2.7-flash1:1,1Kwebp
电商商品抠图mai-image-2.71:1 或 3:4,2Kpng
用于印刷和幻灯片的品牌 logomai-image-2.71:1,2Kpng
叠加在主视觉上的宽幅横幅元素mai-image-2.7自定义,例如 3072x1344webp

这些只是起点,不是规则:每一行都只用了文档中的字段,所以你可以在不改动请求其他部分的情况下,把任务换到另一个档位或尺寸。每种新任务类型的第一批结果,请运行 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。

Share: