熟悉的 HTTP 请求格式只是起点。切换生产流量前，先按照这份清单验证图片效果与集成流程。
1. 盘点正在使用的请求
列出当前输入方式、输出格式、尺寸和编辑参数。本服务支持文件、HTTPS URL 和普通 base64，但未实现 remove.bg 的全部选项。密钥只放在服务器端，并在支持 API 的套餐中创建新密钥。
2. 更换端点和密钥
对支持的 HTTP 请求，保留结构并替换源站地址与 X-API-Key。若库写死 remove.bg 域名，使用它的接口覆盖选项，或直接通过 HTTP 客户端调用。不要向本服务发送 remove.bg 密钥。
- POST https://api.remove.bg/v1.0/removebg + POST https://removebgtool.net/v1.0/removebg X-API-Key: YOUR_NEW_API_KEY
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'image_file=@image.jpg' \
-F 'size=auto' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. 测试前核对参数
兼容指支持相应请求结构，不代表分割结果相同。当前 type 只能为 auto，type_level 只能为 none，channels 只能为 rgba。非空的未支持参数会明确拒绝，不会静默忽略。
| 请求字段 | 本服务支持情况 |
|---|---|
| image_file / image_url / image_file_b64 | 只能选择 image_file、image_url 或 image_file_b64 中的一种输入。 |
| format | 支持 auto、png、jpg、webp，不支持 ZIP。 |
| size | 像素上限因输出格式而异，请核对尺寸表与输出限制。 |
| crop / bg_color | 支持 crop=true/false 和 bg_color。 |
| type / type_level / channels | 分别仅支持 auto / none / rgba。 |
| bg_image_url / shadow / roi / crop_margin / scale / position | 不支持背景图、阴影、ROI、裁切边距、缩放或位置。 |
4. 检查响应和计费
保存前读取响应 Content-Type。默认返回图片字节，按需返回含 result_b64 的 JSON。检查 X-Credits-Charged 与 X-Request-ID。积分属于本服务账户，remove.bg 的密钥和余额不能转移。本 API 的预览与完整分辨率使用相同的单张扣费。
5. 运行代表性测试集
测试常用商品与人像、低对比度边缘、每种输出格式，以及超大文件、无效密钥、未支持参数和积分不足。验证 409、429、超时与处理失败的逻辑，并保留请求 ID 便于排查。
可选 Idempotency-Key：相同密钥、图片和参数，可在 10 分钟内重放成功结果而不重复扣费。重放会重复原 X-Credits-Charged，并附加 X-Idempotent-Replayed: true。处理中返回 409；失败或过期的键仍保留，发起新的计费请求需换新键。不带该请求头时，每次请求独立。客户端超时建议留足 180 秒。
6. 渐进切换，保留回退方式
先将少量自有工作负载切到新接口，观察成功率、图片质量与积分消耗，符合需求后再逐步放量。验证期间保留旧配置。流量分配和回滚由你的应用管理，不是本服务的自动切换功能。
本服务独立于 remove.bg。请验证实际行为，而不只是核对参数名称。