跳到正文

remove.ac · 独立技术指南

从 api.remove.bg/v1.0/removebg 迁移到 remove.ac 接口对照指南

逐字段参数映射、4.4 MB 同步网关与 25 MB 单次票据流式直传说明，以及 cURL、Python、Node.js 与 MCP 调用示例。

发布于 · 资料核对 · Read in English

本文为 remove.ac 独立编写的技术迁移参考。remove.ac 是独立运营的服务，与 remove.bg、Canva 或 Leonardo.Ai 无任何隶属或合作关系。

随着 remove.bg 自助 API 于 2026 年 12 月 1 日停止接收请求，正在调用 POST https://api.remove.bg/v1.0/removebg 的开发团队通常面临两种选择：按 Leonardo.Ai v2 规范重写鉴权、JSON 请求体与响应解析逻辑；或者保留现有 v1.0 调用代码，将地址指向 POST https://remove.ac/v1.0/removebg 并传入 X-Api-Key: rac_live_...。

1. 接口地址、鉴权与一行替换示例

remove.ac 兼容 remove.bg v1.0 核心 HTTP 契约，支持 multipart/form-data、application/json 与 application/x-www-form-urlencoded 请求体，默认直接返回图像二进制字节流（当请求头带 Accept: application/json 时返回含 data.result_b64 与前景坐标的 JSON），并附带 X-Credits-Charged、X-Width、X-Height、X-Type 及 X-Foreground-Top/Left/Width/Height 响应头。

# 迁移前：https://api.remove.bg/v1.0/removebg
# 迁移后：https://remove.ac/v1.0/removebg
curl -f -X POST https://remove.ac/v1.0/removebg \
  -H "X-Api-Key: rac_live_YOUR_API_KEY" \
  -H "Idempotency-Key: sku-1042-main" \
  -F "[email protected]" \
  -F "size=auto" \
  -F "format=png" \
  -o shoe-cutout.png

2. 参数逐项兼容矩阵与边界差异

remove.ac POST /v1.0/removebg 字段兼容对照表
参数 / 请求头remove.ac 行为与迁移注意事项
image_file / image_file_b64 / image_url全部支持。image_file_b64 兼容纯 Base64 或 data:image/...;base64, 前缀；image_url 会做 DNS 解析并拦截内网/回环地址，不跟随重定向。
sizepreview / small / regular（0.25 积分，最高 0.25 MP）；medium（1.5 MP）、hd（4 MP）、4k（10 MP）、full / auto（1 积分，常规最高 25 MP，票据流式最高 40 MP）。
format 与 channelsformat 支持 auto、png、jpg、jpeg、webp、zip；channels 支持 rgba（默认透明图）或 alpha（8 位灰度蒙版）；semitransparency 默认 true。
type 与 type_leveltype 支持 auto、person（自动切换专用人像模型）、product、car、animal、graphic、transportation；type_level（none/1/2/latest）接收并忽略，不报错。
roi、crop、scale、position支持 roi（百分比或像素区域）、crop=true/false、crop_margin、scale（10%–100% 或 original）、position（center、original 或百分比偏移）。
bg_* 与 shadow_*支持 bg_color、bg_image_file / bg_image_file_b64 / bg_image_url，以及 add_shadow、shadow_type（auto/car/drop/soft/contact/reflection/none）、shadow_opacity（0–100）。
Accept: application/json返回 { data: { result_b64, foreground_top, foreground_left, foreground_width, foreground_height } } 及 X-Foreground-* 头。

3. 超过 4.4 MB 的大图直传方案（最高 25 MB / 40 MP）

受无服务器同步网关传输限制，直接 POST /v1.0/removebg 的请求体上限为 4.4 MB、响应体上限为 4.3 MB；若无损透明 PNG 超出 4.3 MB，网关会返回 HTTP 413 并在扣费前全额释放预占积分（0 扣费）。处理最高 25 MB / 40 MP 的棚拍大图时，可传公开 image_url，或使用单次 HMAC 票据流式直传接口 POST /v1.0/removebg/ticket（官方 Node.js SDK、Python SDK、CLI 与 MCP Server 已自动内置切换）：

// Node.js 18+ / TypeScript（超过 4 MB 自动切换 /v1.0/removebg/ticket 流式直传）
import { RemoveAcClient } from "remove-ac";
import fs from "node:fs/promises";

const client = new RemoveAcClient({ apiKey: process.env.REMOVE_AC_API_KEY });
const { buffer, creditsCharged, width, height } = await client.removeBackground(
  "./studio-24mp.png",
  { size: "full", format: "png" },
);
await fs.writeFile("studio-24mp-cutout.png", buffer);
# Python 标准 requests 调用示例（或安装官方 SDK：pip install git+https://github.com/szp2005/remove-ac-sdk.git）
import os, requests

resp = requests.post(
    "https://remove.ac/v1.0/removebg",
    headers={"X-Api-Key": os.environ["REMOVE_AC_API_KEY"]},
    files={"image_file": open("product.jpg", "rb")},
    data={"size": "auto", "crop": "true", "crop_margin": "5%"},
    timeout=60,
)
resp.raise_for_status()
open("product-cutout.png", "wb").write(resp.content)

4. 接入 AI 编程助手（MCP Server）与本地人工精修

如果你在 Claude Desktop、Cursor、Windsurf 或 Antigravity 中用 Agent 批量处理素材，可直接挂载零依赖的 remove-ac-mcp 标准输入输出服务（提供 remove_background_file、remove_background_url 与 get_account_balance 工具）：

{
  "mcpServers": {
    "remove-ac": {
      "command": "npx",
      "args": ["-y", "-p", "remove-ac", "remove-ac-mcp"],
      "env": { "REMOVE_AC_API_KEY": "rac_live_YOUR_API_KEY" }
    }
  }
}

新注册并验证邮箱即送 1 免费积分，可先在 API 在线沙盒 实测返回头与图像效果；需要手动主体点选或使用「擦除 / 恢复」（Erase / Restore）画笔精修边缘时，可直接使用免费的 本机网页编辑器 或 50 张本地批量队列。

参考出处

本文引用的各方官方文档与公开基准数据列表。第三方条款、价格与接口随时可能调整，上线前请以各方最新页面为准。

remove.ac 独立编辑内容。本文不代表与文中提及的任何第三方平台存在合作、背书或官方接替关系。