通过 POST https://remove.ac/v1.0/removebg 调用 NVIDIA L4 GPU 云端抠图 API。注册即送 1 免费积分,内存处理即刻清零、绝不持久存储上传图像。
curl -X POST https://remove.ac/v1.0/removebg \ -H "X-Api-Key: rac_live_YOUR_API_KEY" \ -F "[email protected]" \ -F "size=auto" \ -o no-bg.png
密钥仅保存在当前页面内存中,不会写入浏览器本地存储。每次成功的云端推理消耗 1 积分,失败不扣费。
remove.ac 提供与 remove.bg v1.0 协议 1:1 兼容的生产级 REST 接口,现有脚本仅需将请求地址替换为 https://remove.ac/v1.0/removebg 并传入 X-Api-Key 即可无缝迁移。
计费采用 Supabase Postgres 原子预占(FEFO 最早到期优先):每次成功返回扣减 1 积分(响应头 X-Credits-Charged: 1);若上游超时、参数错误或网络中断,预占积分立即全额释放(扣费 0)。
# Query remaining credits (0 credits charged) curl -s https://remove.ac/v1.0/account \ -H "X-Api-Key: rmac_live_YOUR_API_KEY"
支持 multipart/form-data 或 application/json 请求体,单张输入上限 20 MiB(支持 JPG、PNG、WebP):
| 字段名 | 说明 |
|---|---|
| image_file / image_file_b64 / image_url | 三选一:二进制文件、Base64 字符串或公开 HTTPS 图片链接(含 SSRF 防护与重定向校验)。 |
| size | preview / small / regular(0.25 积分,最高 0.25 MP);medium / hd / 4k / full / auto(1 积分,原图全分辨率)。 |
| format / channels | format 支持 auto / png / jpg / webp / zip;channels 支持 rgba(默认透明图)或 alpha(纯 8-bit 灰度蒙版)。 |
| type / type_level / roi | 完整兼容官方 SDK 主体提示(auto / person / product / car / animal / graphic / transportation)、type_level 与感兴趣区域 roi。 |
| crop / bg_color / shadow_type | crop=true 自动裁切透明边距;bg_color / bg_image_file 合成背景;add_shadow / shadow_type(auto / car / drop / none)控制投影。 |
# Zero-dependency Node.js >= 18 CLI (single file or folder batch) curl -fsSLO https://remove.ac/remove-ac-cli.mjs REMOVE_AC_API_KEY="rac_live_YOUR_API_KEY" node remove-ac-cli.mjs ./photos --output-dir ./cutouts
在请求头传入 X-Api-Key: rmac_live_...(仅在创建时展示一次明文,服务端仅存 SHA-256 摘要)。建议生产调用附带 Idempotency-Key(最长 200 字符),相同载荷重试不会重复扣费,不同载荷复用同一幂等键将返回 HTTP 409。
标准状态码:200 成功返回图像二进制流 · 400 参数或图片格式错误 · 402 积分余额不足 · 403 API Key 无效或已吊销 · 409 幂等键冲突或处理中 · 502 云端 GPU 推理未完成(预占已自动退回)。
云端 L4 GPU 容器仅在内存中解码并推理当前图片,请求返回后立即释放内存,数据库与幂等缓存均不保存输入或输出图像字节;若需图片完全不出浏览器,请直接使用免费网页工作台的「本机处理」模式。