1 · 在线交互式测试场

不看广告看疗效：直接测试真实 API 响应

在此直接向 POST /v1.0/removebg 发起真实测试请求，免注册。已预填体验 Key。可实时检查返回的透明 PNG 二进制字节流以及响应头。

X-Api-Key

当前为匿名演示密钥（受速率限制）。免费获取个人专属 Key (内含 100 点额度) 以进行真实业务测试。

图片素材

拖入图片到此处，点击上传，
或选择下方预设样例

未选择图片

等效 cURL 请求

curl -H "X-Api-Key: live_demo_key" \
  -F "[email protected]" \
  -f https://backgroundremoverapi.com/v1.0/removebg \
  -o cutout.png

API 响应结果 idle

透明 PNG 成果将在此渲染。
棋盘格 = 透明 Alpha 背景。

错误响应体 (完全遵循 remove.bg errors[] 数据结构)

所有图片纯在易失性内存中处理，绝不在磁盘持久化存储。

2 · remove.bg 参数兼容性矩阵

remove.bg 全量参数真实支持度清单

基于 remove.bg 官方 API 手册并在当前服务端逐项实测。我们实事求是地标注不支持的特性——在迁移前清晰知悉，远胜于上线后遇到突发故障。

参数名称 / 协议行为	支持状态	兼容说明
image_file	完整原生支持	multipart/form-data 文件上传 — 与原生规范完全一致
image_file_b64	完整原生支持	Base64 字符串；兼容 data-URI 格式前缀
image_url	完整原生支持	仅支持 http/https 公开网络图片（内置 SSRF 安全防御），大小 ≤30 MB
size	兼容接收 · 默认全量	正常接收不报错；统一直接交付全高清高分辨率图像
type	兼容接收 · 默认全量	通用高保真模型自动识别全部主体；无需按类型手动指定
format	兼容接收 · 默认全量	统一输出标准 32 位 RGBA 透明通道 PNG
bg_color / bg_image_file / bg_image_b64 / bg_image_url	暂不支持	静默忽略（不报错）；建议在前端或业务逻辑中进行背景合成
crop / crop_margin / scale / roi / position	暂不支持	静默忽略；直接返回未裁切的完整前景图像
X-Api-Key header	完整原生支持	相同的请求头鉴权与调用语义
Binary PNG body	完整原生支持	原生 `image/png` 二进制流传输 — 响应解析逻辑零修改
X-Width / X-Height / X-Credits-Charged / X-Processing-Time-Ms	完整原生支持	相同响应头名称与含义；可在上方在线测试场实时核验
GET /v1.0/account	完整原生支持	相同的 credits 账户 JSON 数据结构
Error body `{"errors":[{title,detail,code}]}`	结构完全一致	语义化错误码 — 参见下方映射表

透明的技术权衡：我们在自主独立硬件上运行高算力 CPU 推理——无需在 GPU 队列中排队，不按尺寸阶梯式加价。这也是我们能够以 $79 提供 20,000 张高保真处理的原因。

3 · HTTP 状态码与异常处理对照表

与 remove.bg 完全相同的 HTTP 状态码与 errors[] JSON 异常数据结构——现有的业务异常捕获机制无缝运行。

HTTP	本站错误码	说明	remove.bg 对应状态
400	invalid_request	缺少或无效的图片数据，非法 image_url	400 · 缺少或无效的参数
402	insufficient_credits	账户额度已用尽	402 · 额度已用尽
403	invalid_api_key	未知、失效或已被撤销的 API Key	403 · 无效的 API Key
429	rate_limit_exceeded	10 次/分 (演示环境) · 60 次/分 (注册密钥)	429 · 超过速率限制
5xx	error	图像处理失败 — 建议使用退避重试机制	5xx · 服务端内部错误

在线实测错误返回

传入 X-Api-Key: bgr_live_invalid 请求，您将精准收到与官方一致的错误结构：

HTTP/1.1 403 Forbidden
{"errors":[{"title":"Invalid or revoked API key.","detail":"Invalid or revoked API key.","code":"invalid_api_key"}]}