Remove Background API：生成透明 PNG 抠图

Engineering2026-04-23

Remove Background API 是什么

Remove Background API 接收一个图片 URL，返回一张透明 PNG 抠图。它适合商品上传、广告创意自动化、设计工具素材处理，以及任何需要自动去背景的图像流水线。

好的图像 API 是无聊的。你给它一张图，它返回一个结果，你继续做你的产品。Remove BG 就按这个标准设计。

bash

curl 'https://api.codia.ai/v1/open/remove_bg' \
  -H 'Authorization: Bearer {codia_api_key}' \
  -H 'Content-Type: application/json' \
  --data '{ "image_url": "https://example.com/product.jpg" }'

json

{
  "code": 0,
  "message": "ok",
  "data": {
    "image_url": "https://processed-image-url.com/result.png"
  }
}

一个端点、一个必填字段、一个响应结构,就这些。本文剩下的内容讲我们为了保住这么小的接口放弃了什么,以及 API 在真实图像流水线里的表现。

何谓"干净"的抠图

懒人版的背景去除返回一张带柔软 alpha 通道的图,缩略图看着可以,但放在明亮背景或清晰商品页上就会崩。Remove BG 的目标相反:当客户在商品页放大到细节时,抠图仍然立得住。

具体说,边缘质量那一步做了三件重要的事:

轮廓处的亚像素 alpha。 Mask 是 matte 的,不是阈值化的——细微的边缘发丝、细金银饰、蕾丝、玻璃杯沿保留柔和边缘,而不是被裁到最近的整像素。
前景颜色去污染。 边缘附近像素常带原背景的绿色或红色溢色。API 会移除这种色偏,让主体在任意新背景上合成时不会留光晕。
无投影拖尾。 如果原图在白面上有投影,投影随背景一同去掉。若你想保留投影(部分电商团队要),主体自身的自阴影——鞋底的暗面、马克杯的暗侧——会保留。

实操检验:把返回的 PNG 合成到 #111 背景上。如果看到明显亮边,这张抠图不干净。Remove BG 在商品、人、宠物、食物、家具、车辆上都应通过。会有挑战的是运动模糊主体,以及主体与杂乱背景共享色盘的场景。

延迟预算

公示的处理时间约 600 ms。这是模型推理加轻量 I/O;从你发请求到拿到结果 URL 的端到端延迟在 800–1200 ms,取决于图像尺寸与区域。对批量负载,API 并发能力强——一个 Key 在触发速率限制前,通常能从单进程并发数百请求,对商品上传类的交互流足够。

如果你是同步 UI ——用户拖图、期望立刻看结果——800 ms 的手感很好。如果你是夜间批量处理 50,000 SKU,起一个 worker 池、瞬时失败重试,并按速率限制大小来设置并发。

API 的五种落地形态

1. 电商商品上传。 商家上传商品图时调用 Remove BG，把透明 PNG 与原图一并存储，让模板系统按品牌背景合成：列表页白底、广告活动色、节日背景等。你不需要再次跑模型。

2. 设计工具素材管道。 把图拖进画布,背景就没了。这就是 Figma / Canva 的形态,也是我们调优的延迟目标。

3. 相册类 App。 端侧模型越来越强,但体积大、老机慢、更新贵。如果你的 App 本来就要联网做别的事,API 抠图常常是正确选择——二进制更小、结果更好、迭代更容易。

4. 广告创意自动化。 商品 feed 驱动的可变背景广告模板:抠一次,合成 N 次,上线 N 套创意。Remove BG 是"抠一次"的那一步。

5. AI 生成流水线。 生成器在纯色背景上产出主体,第二条流水线把它合成到场景里。这一步的干净 alpha,是"可用产出"与"明显 AI 糊边"之间的差别。

失效模式与处理

每个图像 API 都有它不喜欢的输入。值得关注的:

极低分辨率(长边 < 400 px)。模型需要足够的信号去 matte 边缘;低于这个阈值,抠图显得量化。面向用户的产品应在调用前拒收。
已带透明度的输入。 若源图已有 alpha,模型会把透明区当作背景。若想保留原有透明度,先在白底上扁平化。
极端运动模糊。 赛车、极限运动。模型能保住主体,但边缘会比更清晰的捕获更柔和。
主体与背景撞色。 白底白裙、黑沙发黑狗。结果仍可用,但边缘置信度下降。这种情况值得加一道人工评审。

响应里的 code 字段:0 是成功。非 0(配人类可读的 message)代表输入问题——URL 不可达、格式不支持、图过大、触发速率限制。处理非 0 的策略是:网络错重试,输入错快速失败反馈用户。

计费与运维注意点

公开方案按成功调用计量,未用额度按月滚动,以免浪费。大体量场景——月处理数千万张——可走企业方案:固定额度承诺、独立 Key、自定义速率限制、优先队列。免费侧没有尺寸分层:质量一致,变量只是配额和 SLA。

输出图通过 CDN URL 提供,有效期足够你下载缓存。不要热链;拉下来存到自己桶里再对外。URL 只对当次请求有效,不是长效。

快速上手

在 codia.ai/dashboard/developer 获取 Key。
对任意一张商品图跑上面那条 curl。
下载 data.image_url,在深色背景上合成,放大看边缘。
看起来不错——通常也是——把它接进流水线作为上传后的那一步。

完整参考、错误码、量价表在 /api#remove-background。

目标是一个无聊的 API:一个端点、快速干净的抠图、在负载下可靠。如果你接完就不用再想它,那就赢了。

FAQ

Remove Background API 返回什么格式？

API 返回处理后的透明 PNG 图片 URL。生产环境中建议下载结果，存入自己的对象存储或 CDN 后再对外提供。

它适合商品图去背景吗？

适合。商品图是最典型场景之一，尤其适合电商列表、 marketplace 上传、广告模板和商品目录标准化。

可以直接热链返回 URL 吗？

不建议。返回 URL 应视为处理结果地址。请下载、缓存并从自己的存储服务分发最终资产。