背景削除 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 を受け付けます。3 つの画像フィールドのうち 1 つだけを送ってください。

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）、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"}]}

制限

• 1 アカウント 1 日 50 枚、すべてのキーで共有。キーは同時に 3 個まで持てるので、入れ替えができます。
• アップロードは最大 22 MB。出力は最大 25 MP、PNG は 10 MP。
• リクエストはキューに入り、数件ずつ処理されます。1 枚あたり数秒、大きな写真はそれ以上かかります。
• 有料プランはまだないため、今のところ 1 日の枠が上限です。

切り抜き品質の目安

切り抜きには、背景リムーバーと同じ isnet-general-use モデルを使います。ふつうの背景の前にある商品・人物・動物では安定しています。細い髪、ガラス、背景と似た色の被写体は苦手で、remove.bg 自身のモデルのほうがよい結果になることがあります。本番の処理を移す前に、自分の画像を何枚か試してください。

よくある質問

remove.bg の公式な後継ですか？

いいえ。Imagic AI は remove.bg、Canva、Leonardo.Ai とは関係ありません。既存のコードが動くよう、remove.bg のリクエスト形式を受け付けているだけです。

API は無料ですか？

はい。各アカウントは 1 日 50 枚まで無料です。preview を含め、どのサイズも 1 枚として数えます。

remove.bg 公式のクライアントライブラリは使えますか？

ベース URL を設定できるライブラリは、https://imagic-ai.com/api に変えれば動きます。api.remove.bg が埋め込まれているライブラリは、その 1 行を書き換えるか小さなラッパーが必要です。

画像は保存されますか？

API に送った画像は処理されてレスポンスで返されます。ギャラリーに追加されたり学習に使われたりはしません。