100% 兼容 remove.bg 官方协议 · 极速无缝平替
开发者 AI 智能抠图 API
发丝级超清 AI 边缘分割。完全兼容现有 remove.bg 请求入参与出参，30 秒零代码改动迁移，每次调用成本低至 $0.05。
快速开始 (Quickstart)
使用任意 HTTP 客户端发起 POST 请求，直接输出高保真透明 PNG 图片二进制流。
API 接口地址
POSThttps://api.removebg.top/v1.0/removebg主要接口
POSThttps://removebg.top/v1.0/removebg备用容灾
curl -H 'X-Api-Key: sk_your_api_key' \
-F 'image_file=@photo.jpg' \
-F 'size=auto' \
-f https://api.removebg.top/v1.0/removebg -o output.png请求参数规范 (Request Parameters)
支持 multipart/form-data、application/x-www-form-urlencoded 或 application/json 提交。
| 参数名 | 类型 | 是否必填 | 说明与取值 |
|---|---|---|---|
| image_file | File (Binary) | 三选一 | 上传本地图片文件（multipart/form-data 格式，最大 10MB，支持 JPG、PNG、WebP）。 |
| image_url | String (URL) | 三选一 | 图片的公开可访问网络链接（支持 HTTP/HTTPS）。 |
| image_file_b64 | String (Base64) | 三选一 | Base64 编码的图片数据（可带或不带 data:image/... 前缀）。 |
| size | String | 可选 (默认 auto) | 输出图片分辨率：auto (自动超清)、preview (极速缩略图)、full (最高分辨率)。 |
| format | String | 可选 (默认 auto) | 输出格式：auto (默认 PNG 透明图)、png (透明 PNG)、jpg (纯色底 JPG)。 |
| bg_color | String | 可选 | 自定义替换背景色（如 pure white: FFFFFF, deep black: 000000, ID blue: 4A90E2）。未指定时默认透明。 |
请求与响应头 (Headers)
| Header | 类型 | 说明 |
|---|---|---|
| X-Api-Key | Request Header | 用户的 API 密钥（格式：sk_...）。可在控制台一键生成。 |
| Authorization | Request Header | 标准 Bearer 鉴权支持：Bearer sk_...（与 X-Api-Key 二选一即可）。 |
| Content-Type | Response Header | 返回二进制图片流：image/png。 |
| X-Credits-Charged | Response Header | 本次请求消耗的积分数（正常为 1.0）。 |
| X-Credits-Remaining | Response Header | 用户账户扣减后的最新剩余积分余额。 |
状态码与异常响应 (Status Codes)
| 状态码 | 产生原因与排查 |
|---|---|
| 400 Bad Request | 缺少图片输入（image_file / image_url / image_file_b64 均为空）或参数格式错误 |
| 401 Unauthorized | API Key 缺失、格式无效或已被撤销 |
| 402 Payment Required | 积分余额不足，请充值积分包或开通套餐 |
| 429 Too Many Requests | 触发并发调用频率限制 |
| 500 Server Error | AI 抠图模型处理失败（系统不会扣减积分） |
开发者高性价比之选
每次调用仅需 $0.05 · 永久有效
没有昂贵的月费绑定或强制过期机制。新注册即享 10 次免费调用，随用随充，无缝支持高并发批量自动化。
开发者常见问题 (FAQ)
关于 API 兼容性、计费机制及安全性的详细解答。