BackGone

抠图 API

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

创建 API 密钥从 remove.bg 迁移

试试抠图 API

上传一张图，直接看到端点返回的效果。演示走网站免费额度——匿名每天 2 张、登录每天 5 张——结果按免费档封顶 1024px。用自己的密钥调用则按张扣积分：不受免费档每日张数限制，返回全分辨率。

PNG、JPEG、WebP 最大 10 MB · HEIC 在浏览器里转换 · REST API 本身只收 PNG、JPEG、WebP

抠图 API 快速上手（三步）

创建密钥

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

创建 API 密钥

充值 API 积分

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

查看 API 定价

调用端点

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

抠图 API 端点

API 密钥

创建密钥

登录后进入「设置 → API 密钥」，点击创建。密钥只显示一次，服务端只存哈希——请立即复制进你的密钥管理工具。创建密钥免费；调用从预付 API 积分扣费，这是与网站积分相互独立的余额，$10 起充、永不过期。

我的 remove.bg API 密钥还能用吗？

不能。API 密钥在服务商之间不通用：remove.bg 的密钥只能调 remove.bg 的服务器，而它们将于 2026 年 12 月 1 日关停，任何其他服务都无法接受这把密钥。迁移只需两处改动——换一把密钥、换一个端点：

API 密钥

remove.bg
在 remove.bg 签发
BackGone
sk_… —— 在「设置 → API 密钥」创建

鉴权头

remove.bg
X-Api-Key: <key>
BackGone
Authorization: Bearer sk_…

端点

remove.bg
POST https://api.remove.bg/v1.0/removebg
BackGone
POST https://backgone.com/api/v1/remove

2026-12-01 之后可用

remove.bg
否——API 随站关停
BackGone
是

不想写代码？也不需要密钥—— 批量抠图工具 不用写代码就能处理整个文件夹的图。

抠图 API 端点

POSThttps://backgone.com/api/v1/remove

鉴权

把密钥放进 Bearer 令牌。没有有效密钥返回 401——此处不接受会话 Cookie。

请求

image_file

类型
file
说明
要处理的图片：PNG / JPEG / WebP，最大 10 MB、**5000 万像素**（8000×6250）——与 remove.bg 公布的上限相同。先缩放仍然值得（上传越小、端到端越快），代码示例下面有一行命令。与 image_url 二选一，且必须提供一个。

image_url

类型
字符串
说明
与 image_file 二选一：一个 https 图片地址，由我们服务端抓取——同样的限制、同样的价格与计费。不跟随跳转、拒绝环回与内网地址，需要这两者的文件请自己直接托管。image_file 与 image_url 必须且只能提供一个。

format

类型
字符串
说明
可选。png（默认）或 webp——都保留透明通道，WebP 体积通常小得多。刻意不提供 JPG：填底色是站内功能。WebP 输出上限 1200 万像素，更大的图请用 PNG。

Idempotency-Key

类型
请求头
说明
可选。每个不同的请求用一个唯一值：同值同图重试不会重复计费（24 小时窗口）。同值换图会返回 400。

响应

调用成功时返回的就是图片本身（不是 JSON）：默认 content-type 为 image/png，传 format=webp 时为 image/webp，直接把响应体写入文件即可。出错时返回 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)
先缩放（可选，推荐）
# cap the longest side at 3000px before uploading
magick in.jpg -resize '3000x3000>' small.jpg    # ImageMagick
sharp(input).resize(3000, 3000, { fit: 'inside' })  # Node.js
img.thumbnail((3000, 3000))                     # Python (Pillow)

5000 万像素以内并非必须，但小图端到端更快、也更省你的带宽。大图会跳过我们的「未检测到主体」检查（改用输出体积判断），详见错误码表。

在 AI Agent 里使用 BackGone（MCP）

BackGone 在 /mcp 运行一个 Model Context Protocol 服务器。支持远程 Streamable HTTP MCP 的 Agent 可以自动发现工具，并调用与 REST API 相同的引擎——不需要单独接入，也没有单独的价格。

POSThttps://backgone.com/mcp

认证

remove_background 需要提供 API 密钥（"Authorization: Bearer sk_..."），并按 API 积分计费（每张成功图 1 积分，与 REST API 同一个余额）。check_photo_requirements 与 get_pricing 免费、无需密钥。

工具

check_photo_requirements

返回什么
某个国家的护照/证件照官方要求，附官方来源 URL 与我们核验的日期。不传国家时返回支持的国家列表。
费用
免费

get_pricing

返回什么
当前 API 充值档位与站内套餐，与结账使用的是同一份价格源。
费用
免费

remove_background

返回什么
去掉一张图片（https 链接或 base64）的背景，返回透明 PNG 或 WebP。输入格式：PNG、JPEG 或 WebP。
费用
1 API 积分

连接客户端

在任意支持远程 Streamable HTTP 的 MCP 客户端里填写该端点。不同客户端的配置字段名不同，下面是最关键的值。密钥只放在服务端。

mcp.json
{
  "mcpServers": {
    "backgone": {
      "type": "http",
      "url": "https://backgone.com/mcp",
      "headers": { "Authorization": "Bearer sk_your_api_key" }
    }
  }
}

MCP 调用与 REST API 完全同一套计费——相同的积分、预算与限流；没有单独的 MCP 价格，也没有批量工具：批量仍是站内功能。

OpenAPI 3.1 文档Agent 清单（llms-full.txt）

从 remove.bg API 迁移

remove.bg 自助 API 将于 2026 年 12 月 1 日停止接受请求；企业 API 合同继续正常履行。对自助集成来说，这张表就是迁移的全部工作——或者走下面 remove.bg 官方指向的 Leonardo.Ai 路径。

端点

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 或 image_url

参数

remove.bg
size、format、bg_color、crop、scale、position、type、shadow_type 等
BackGone
只有 format（png 或 webp）。始终按你上传的分辨率输出透明底结果——换底色、预设与打印排版都留在网站端。

响应

remove.bg
图片字节；format 可选 PNG / JPG / WebP / ZIP
BackGone
图片字节；PNG（默认）或 WebP，一律带透明通道

计费单位

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

remove.bg 把它的 API 客户送到哪里

remove.bg 自己的 API 页面现在指向 Leonardo.Ai（Canva 旗下）作为迁移目标，而 Canva 的公开 Connect API 根本没有抠图接口。如果你在权衡那条路，下面是如实对比。

端点

Leonardo.Ai
POST https://cloud.leonardo.ai/api/rest/v2/generationssync
BackGone
POST https://backgone.com/api/v1/remove

鉴权

Leonardo.Ai
Authorization: Bearer <Leonardo API key>
BackGone
Authorization: Bearer sk_… ——头格式相同，客户端这部分不用改

请求体

Leonardo.Ai
只收 JSON。图片放在 parameters.guidances.image_reference 里
BackGone
multipart/form-data，字段名 image_file

响应

Leonardo.Ai
永远是 JSON：默认 results[0].url，要 base64 则是 results[0].dataB64——拿到图片前还得再取一次或解码
BackGone
透明图片本身（默认 PNG，传 format=webp 则为 WebP），直接作为响应体流式返回——不用二次请求，也不用解码

结果存在哪

Leonardo.Ai
默认存进你的 Leonardo 素材库；设 ephemeral: true 才给 30 分钟有效的链接
BackGone
从不保存——没有素材库、没有存储桶、没有 30 分钟的抢时间窗口

输出格式

Leonardo.Ai
png、jpg、webp
BackGone
带透明通道的 PNG

每张价格

Leonardo.Ai
$0.1047
BackGone
$0.020–$0.033

费用反馈

Leonardo.Ai
响应体里的 cost 对象
BackGone
响应头 x-backgone-credits-charged

两列数据均取自 2026-11-04 核验的一手来源：remove.bg 的 FAQ 与 API 页、Leonardo 自己的 remove.bg 迁移指南（2026-09-02 更新；$0.1047 与「只回 JSON」出自该页），以及 Canva 公开的 Connect API 规范——其中没有抠图这项。我们与二者均无关联。

创建 API 密钥

remove.bg 一列取自其公开 API 文档，核对于 2026-11-04。其参数会变动——切换前请与你自己的集成再比对一次。

remove.bg 关停时间线与替代品对比remove.bg API 迁移指南

限制与错误码

所有响应使用以下状态码。429 与 503 请退避重试；4xx 说明请求本身需要修正。

400

含义
请求格式错误
怎么处理
请求体不是 multipart/form-data、缺少 image_file、类型不是 PNG / JPEG / WebP，或同一个 Idempotency-Key 被用于不同的图片。

401

含义
密钥缺失或无效
怎么处理
检查 Authorization 头，并确认密钥仍处于启用状态。不扣费。

402

含义
API 积分不足
怎么处理
充值 API 积分。站内积分不能用于此处。不扣费。

413

含义
图片过大
怎么处理
两个独立上限：文件 10 MB，像素 5000 万——1.25 MB 的 JPEG 完全可能是 2400 万像素。撞到就缩一下最长边。不扣费。

409

含义
幂等冲突
怎么处理
同一 Idempotency-Key 的另一个请求仍在执行。稍后重试；本次未计费。

422

含义
未检测到主体
怎么处理
模型已运行，但图中没有明确主体（风景照常见）。请换一张有清晰人物、商品或物体的图。超过 600 万像素时我们不再解码结果来测量，改用输出文件体积判断——对「空结果」准确，但它是启发式、不是像素测量。不扣费。

429

含义
请求过于频繁
怎么处理
按 Retry-After 等待后重试。密钥日上限与请求频率限制都返回 429。不扣费。

502

含义
引擎错误
怎么处理
模型执行失败，或上游拒绝服务。请稍后重试；若持续出现，通常是上游在限流。不扣费。

503

含义
API 已暂停或当日预算用尽
怎么处理
运维暂停了 API，或当日（UTC）全局预算已用完。00:00 UTC 后重试，或发邮件联系我们。不扣费。

服务状态

由我们自己的请求日志统计（与计费同一份数据）。不承诺 SLA——这只是实际发生的情况。

最近 30 天还没有 API 调用，暂无可报告的数据。

只统计真正到达引擎的调用；计费、限流与未检测到主体的结果不计入。另外，平台级失败（请求在我们的代码跑完之前就被终止）同样不在这里体现。

接入前请知悉

三件事，直说：

  • 支持幂等键：带上 Idempotency-Key，同一请求的重试永远不会被重复计费（24 小时窗口）。我们是重跑模型而不是存你的图，因此返回的字节不保证与首次完全一致。
  • 不承诺 SLA，也没有队列。调用是同步处理的，API 流量没有优先通道。
  • 我们不存储你的图片。图片只在内存中处理，绝不用于训练模型；每次调用的元数据（密钥、状态、耗时、扣费）会保留，用于计费与滥用防治。

未消耗的 API 积分可在购买后 14 天内退款，已消耗的不退。

常见问题

准备好在 12 月 1 日前完成迁移了吗？

创建一个密钥、充值 $10、跑一次调用。大多数 remove.bg 集成改两行代码即可。

创建 API 密钥查看 API 定价

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