端点
POST
https://backgone.com/api/v1/remove鉴权
把密钥放进 Bearer 令牌。没有有效密钥返回 401——此处不接受会话 Cookie。
请求
image_file
- 类型
file- 说明
- 要处理的图片:PNG / JPEG / WebP,最大 10 MB。没有 image_url 字段——请直接上传字节。
响应
调用成功时返回的就是透明底 PNG 本身(不是 JSON),content-type 为 image/png,直接把响应体写入文件即可。出错时返回 JSON,含数字错误码与可读说明。
响应头
x-backgone-credits-charged
- 说明
- 本次调用扣除的积分——成功时为 1。
x-backgone-credits-remaining
- 说明
- 本次调用后账户剩余的 API 积分。
代码示例
把 sk_YOUR_KEY 换成你创建的密钥。三个示例都会把结果写入 no-bg.png。
curl
curl -X POST https://backgone.com/api/v1/remove \
-H "Authorization: Bearer sk_YOUR_KEY" \
-F "image_file=@/path/to/photo.jpg" \
-o no-bg.pngNode.js
import fs from 'node:fs/promises';
const form = new FormData();
form.append('image_file', new Blob([await fs.readFile('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://backgone.com/api/v1/remove', {
method: 'POST',
headers: { Authorization: 'Bearer sk_YOUR_KEY' },
body: form,
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
await fs.writeFile('no-bg.png', Buffer.from(await res.arrayBuffer()));Python
import requests
res = requests.post(
"https://backgone.com/api/v1/remove",
headers={"Authorization": "Bearer sk_YOUR_KEY"},
files={"image_file": open("photo.jpg", "rb")},
timeout=60,
)
res.raise_for_status()
open("no-bg.png", "wb").write(res.content)从 remove.bg API 迁移
remove.bg API 将于 2026 年 12 月 1 日随网站一起关停。对多数集成来说,这张表就是迁移的全部工作。
端点
- remove.bg
POST https://api.remove.bg/v1.0/removebg- BackGone
POST https://backgone.com/api/v1/remove
鉴权
- remove.bg
- 请求头 X-Api-Key
- BackGone
- 请求头 Authorization: Bearer sk_…
请求体
- remove.bg
- multipart/form-data,字段 image_file 或 image_url
- BackGone
- multipart/form-data,字段只有 image_file
参数
- remove.bg
- size、format、bg_color、crop、scale、position、type、shadow_type 等
- BackGone
- 没有参数。始终按你上传的分辨率输出透明底 PNG——换底色、预设与打印排版都留在网站端。
响应
- remove.bg
- 图片字节;format 可选 PNG / JPG / WebP / ZIP
- BackGone
- 图片字节;始终是带透明通道的 PNG
计费单位
- remove.bg
- 按积分计费,随分辨率变化;订阅积分每月重置
- BackGone
- 每成功一张扣 1 积分;预付积分永不过期
价格
- remove.bg
- 其 API 页面未标价
- BackGone
- $0.020–$0.033/张
限流
- remove.bg
- 每分钟 500 百万像素张;超限返回 429 与 Retry-After
- BackGone
- 每账号每 200 毫秒 1 次(约 5 次/秒);超限返回 429 与 Retry-After
创建 API 密钥
remove.bg 一列取自其公开 API 文档,核对于 2026-09-20。其参数会变动——切换前请与你自己的集成再比对一次。
限制与错误码
所有响应使用以下状态码。429 与 503 请退避重试;4xx 说明请求本身需要修正。
400
- 含义
- 请求格式错误
- 怎么处理
- 请求体不是 multipart/form-data、缺少 image_file,或类型不是 PNG / JPEG / WebP。
401
- 含义
- 密钥缺失或无效
- 怎么处理
- 检查 Authorization 头,并确认密钥仍处于启用状态。不扣费。
402
- 含义
- API 积分不足
- 怎么处理
- 充值 API 积分。站内积分不能用于此处。不扣费。
413
- 含义
- 图片过大
- 怎么处理
- 上传前压到 10 MB 以内。不扣费。
429
- 含义
- 请求过于频繁
- 怎么处理
- 按 Retry-After 等待后重试。不扣费。
502
- 含义
- 引擎错误
- 怎么处理
- 模型执行失败,或图中未检测到主体。稍后重试。不扣费。
503
- 含义
- API 已暂停或当日预算用尽
- 怎么处理
- 运维暂停了 API,或当日(UTC)全局预算已用完。00:00 UTC 后重试,或发邮件联系我们。不扣费。
接入前请知悉
三件事,直说:
- 还没有幂等键。网络超时后的重试算一次新调用,可能重复扣费——请在你自己的侧记录请求 id。
- 不承诺 SLA,也没有队列。调用是同步处理的,API 流量没有优先通道。
- 我们不存储你的图片。图片只在内存中处理,绝不用于训练模型;每次调用的元数据(密钥、状态、耗时、扣费)会保留,用于计费与滥用防治。
未消耗的 API 积分可在购买后 14 天内退款,已消耗的不退。
准备好在 12 月 1 日前完成迁移了吗?
创建一个密钥、充值 $10、跑一次调用。大多数 remove.bg 集成改两行代码即可。