异步任务状态
POST 创建任务。GET 轮询 queued、processing、succeeded 或 failed。
背景移除 API
把抠图接到你的产品里，而不是换掉整套栈
提交公开图片 URL，拿到任务 ID，轮询直到成功。标准和 HD 与网站共用同一积分账户。
使用 API 需要付费套餐或购买积分。
- 模式
- 异步
- 计费
- 每张 1 / 2 积分
- 格式
- PNG、WebP
快速开始
curl -X POST 'https://bgly.net/api/v1/bg/removals' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"image_url":"https://example.com/photo.jpg","precision":"standard"}'从 API Key 到抠图结果
接口是异步的，模型处理期间不需要一直占用连接。
01
创建 API Key
登录并购买套餐或积分，然后在设置 → API Keys 创建密钥。
02
提交抠图
向 /api/v1/bg/removals POST image_url。可选 subject、precision、output_format。
03
轮询结果
每隔几秒 GET 任务 ID，直到 status 为 succeeded，再下载 output.url。
API 能力
面向商品图、刊登和流水线
一套版本化契约。供应商细节留在内部；你的应用只看到任务、积分和结果 URL。
共用积分账户
标准 1 积分，HD（precision high）2 积分。失败任务自动退回。
主体与 HD 模式
可选手动 auto、product、portrait、hair，以及 standard 或 high 精度。
安全重试
带上 Idempotency-Key，网络重试会返回原任务，而不是再扣一次费。
团队用 API 自动化什么
一张商品图或成千上万张刊登图，流程相同。
电商目录
为 Amazon、Shopify 和广告清洗产品图，不必搭影棚。
批量流水线
用任务 ID 和幂等创建，把大量独立任务排进你自己的队列。
你自己的产品
在编辑器、素材库或卖家后台里提供抠图能力。
API 定价
与网站使用同一套积分
没有单独的 API 套餐。购买 Lite、Pro 或积分包后，用 Key 调用即可。
- 标准精度：每张 1 积分。
- HD 精度：每张 2 积分。
- 失败任务会自动退回预扣积分。
当前边界
第一版公开 API 是 URL 输入 + 轮询结果。按这些限制设计，接入会更顺。
- 目前只接受公开 HTTP(S) 图片 URL，暂不支持 multipart 上传。
- 暂无用户 Webhook。请轮询 GET /api/v1/bg/removals/:id。
- 使用 API 需要付费套餐或购买积分。结果 URL 可能过期，请尽快下载。
API 常见问题
评估和接入 bgly API 的实用回答。