抠图 API

一个端点:图片进,透明底 PNG 出。预付积分、密钥自助创建、不用联系销售——一分钟就能跑通第一次调用。

三步跑通

创建密钥

登录后在「设置 → API 密钥」创建。密钥只显示一次,服务端只存哈希——请立刻存进你的密钥管理工具。

创建 API 密钥

充值 API 积分

API 积分与站内积分是两个余额。$10 起充、永不过期,按档位 $0.020–$0.033/张。

查看 API 定价

调用端点

以 multipart/form-data 提交,字段名 image_file。成功扣 1 积分;失败不扣费。

端点

端点

POSThttps://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.png

Node.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 集成改两行代码即可。

support@backgone.com·隐私政策·服务条款