抠图 API

从 remove.bg 迁移

remove.bg 已宣布其独立服务将于 2026 年 12 月 1 日关闭，自助 API 请求同日停止，API 迁往 Leonardo.Ai。如果你的代码调用的是 api.remove.bg，把地址改成这里即可：

请求头仍是 X-Api-Key，字段名不变，错误格式也与 remove.bg 一致，所以能设置基础 URL 的客户端库可以直接使用。

获取密钥

1. 使用 Google 登录。
2. 打开“我的账户”，在“抠图 API 密钥”中创建密钥。
3. 密钥出现时立即复制，它只显示一次。

快速开始

图片可以作为文件上传、base64 或公开 URL 发送。响应正文就是处理好的图片。

curl -H "X-Api-Key: $IMAGIC_API_KEY" \
  -F "image_file=@photo.jpg" \
  -F "size=auto" \
  -o no-bg.png \
  https://imagic-ai.com/api/v1.0/removebg

import os, requests

response = requests.post(
    "https://imagic-ai.com/api/v1.0/removebg",
    files={"image_file": open("photo.jpg", "rb")},
    data={"size": "auto"},
    headers={"X-Api-Key": os.environ["IMAGIC_API_KEY"]},
)
response.raise_for_status()
with open("no-bg.png", "wb") as out:
    out.write(response.content)

import { readFile, writeFile } from "node:fs/promises";

const form = new FormData();
form.append("image_file", new Blob([await readFile("photo.jpg")]), "photo.jpg");
form.append("size", "auto");

const res = await fetch("https://imagic-ai.com/api/v1.0/removebg", {
  method: "POST",
  headers: { "X-Api-Key": process.env.IMAGIC_API_KEY },
  body: form,
});
if (!res.ok) throw new Error(JSON.stringify(await res.json()));
await writeFile("no-bg.png", Buffer.from(await res.arrayBuffer()));

请求字段

POST /api/v1.0/removebg 接受 multipart/form-data、application/x-www-form-urlencoded 或 JSON。三个图片字段只能发送其中一个。

不支持 scale、position、roi、bg_image_url、bg_image_file 以及阴影相关选项。使用这些选项的请求会返回 400，而不是悄悄返回一张不同的图。

响应

默认情况下，响应正文就是图片本身，并带有这些响应头：X-Width、X-Height、X-Type、X-Foreground-Top、X-Foreground-Left、X-Foreground-Width、X-Foreground-Height、X-Credits-Charged（始终为 1），以及表示每日额度的 X-RateLimit-Limit / -Remaining / -Reset。发送 Accept: application/json 则返回 JSON：

{
  "data": {
    "result_b64": "iVBORw0KGgo…",
    "foreground_top": 115,
    "foreground_left": 477,
    "foreground_width": 637,
    "foreground_height": 824
  }
}

剩余额度

GET /api/v1.0/account 返回与 remove.bg 相同结构的账户信息。credits.total 和 api.free_calls 都是今天剩余的张数。

错误

错误使用 remove.bg 的格式，见下方。失败的请求不消耗额度。

{"errors": [{"title": "Daily limit of 50 images reached. …", "code": "rate_limit_exceeded"}]}

限制

• 每个账号每天 50 张，由所有密钥共用。每个账号最多 3 个有效密钥，方便轮换。
• 上传最大 22 MB。输出最高 25 MP，PNG 最高 10 MP。
• 请求会排队，每次处理少量几张。每张图通常几秒，大图更久。
• 目前还没有付费档，每日额度就是上限。

抠图效果预期

抠图使用 isnet-general-use 模型，与“背景移除工具”相同。对普通背景前的商品、人物和动物效果稳定。细发丝、玻璃以及与背景颜色接近的主体是它的弱项，这些情况下 remove.bg 自己的模型可能更好。迁移生产流程之前，请先用你自己的几张图测试。

常见问题

这是 remove.bg 官方的替代服务吗？

不是。Imagic AI 与 remove.bg、Canva、Leonardo.Ai 均无关联。我们只是接受 remove.bg 的请求格式，让现有代码可以继续工作。

API 免费吗？

免费。每个账号每天 50 张，不收费。包括 preview 在内，任何尺寸都按 1 张计。

remove.bg 官方客户端库能用吗？

能设置基础 URL 的库，把它改成 https://imagic-ai.com/api 即可。把 api.remove.bg 写死的库，需要改源码里的那一行，或者包一层。

你们会保存我的图片吗？

发给 API 的图片处理后随响应返回，不会进入任何图库，也不会用于训练。