背景除去 API とは？
ImgGen AI 背景除去 API は、写真の前景被写体を背景から分離し、透過 PNG を返す REST エンドポイントです。HTTPS で画像をアップロードすると AI が被写体を自動的に検出し、切り抜き結果が JSON レスポンス内に base64 エンコードされて返ります。マスクも手動選択も必要ありません。
これは ImgGen AI 画像編集 API の 7 つのエンドポイントのひとつで、いずれも同じ API キー、同じベース URL、同じリクエストとレスポンスの形式を共有しています。コードからではなくブラウザでもこの機能が必要な場合は、同じ AI モデルが Background Remover ツールを動かしています。
リクエストパラメータ
https://app.imggen.ai/v1/remove-background に POST リクエストを送り、Authorization ヘッダーの API キーで認証します。
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|
| image | file | 必須 | — | The input image to process. Accepts JPEG (JPG), PNG and WebP, up to 25 MB. |
背景除去 API はどう組み込みますか？
ImgGen アカウントで API キーを作成し、環境変数に設定してエンドポイントを呼び出します。同じリクエストを cURL、Node.js、Python で示します。
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))レスポンス
成功した呼び出しは JSON を返します。結果は base64 エンコードされているので、ディスクやオブジェクトストレージに書き込む前にデコードしてください。成功したレスポンスにはいずれも、呼び出し後の残高を示す X-Credit-Remaining ヘッダーが付きます。
{
"success": true,
"message": "Background removed successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}知っておきたい制限と挙動
このエンドポイントは JPEG（JPG）、PNG、WebP を最大 25 MB のファイルサイズで受け付け、60 秒以内に同期的に応答します。ジョブをポーリングする必要も、Webhook を設定する必要もありません。
透過 PNG 出力
結果は本物のアルファチャンネル付きで返るため、2 回目のリクエストなしに任意の背景・色・テンプレートへ合成できます。
マスク不要
被写体検出は自動で、前景は背景から自動的に分離されます。塗ったり、なぞったり、第 2 のパラメータとして渡したりするものはありません。入力画像を送って、結果を読むだけです。
何も保存しません
入力は呼び出しの間だけ一時オブジェクトに保持され、その後削除されます。保持が許されていない顧客の写真を扱うときに役立ちます。
背景除去 API は何に使われていますか？
各チームがこのエンドポイントを本番環境に投入し、プログラムから大規模に画像を処理している場面です。
EC のカタログ
仕入先の商品画像をアップロード時に背景除去し、手作業の編集工程なしに、どの商品ページにも清潔で統一感のある切り抜きを並べます。
マーケットプレイスとクラシファイド
出品者がアップロードした写真を自動的に整えます。すべてのアップロードをエンドポイントに通し、透過 PNG を元画像と並べて保存します。
オンデマンド印刷
モックアップに合成する前にアートワークや被写体を切り出し、どの製品サイズでもプレビューが正しく表示されるようにします。
デザイン・編集系 SaaS
モデルの学習もホスティングも、AWS などでの自前の推論も不要のまま、自社プロダクトの中でワンクリックの背景除去をユーザーに提供できます。
背景除去 API の料金は？
成功した呼び出し 1 回につき 1クレジット かかるため、1 枚あたりの実質コストはご利用のプランによって決まります。クレジットはプランから消費され、すべてのエンドポイントと Web エディターで共通なので、ツールごとに別枠を購入する必要はありません。失敗した呼び出しは自動的に返金されます。詳細は料金ページをご覧ください。
| プラン | 料金 | クレジット | API |
|---|---|---|---|
| Free | $0 | 無料クレジット 50（一度限り） | API アクセスなし |
| Starter | $9.99 / month | 月 400 クレジット | API アクセス込み |
| Pro | $29.99 / month | 月 1,400 クレジット | API アクセス + 優先サポート |
| Enterprise | Custom | カスタム量 | 専有インフラ |
クレジット料金と制限の最終確認日 2026-08-27.
関連するエンドポイントとツール
背景除去 API を使っているチームが、次に手を伸ばすことが多いのはこちらです。
背景除去 API のよくある質問
- 写真を受け取り、背景を除去して被写体を透明レイヤー上に残した同じ写真を返す HTTP エンドポイントです。エディターではなく API なので、バックエンドのジョブ、キューのワーカー、ユーザーのアップロード処理から呼び出せば、誰もブラウザを開かないまま何千枚もの画像を処理できます。
- ImgGen アカウントで API キーを作成し、image フィールドを含むマルチパートフォームを Authorization: Bearer ヘッダー付きで https://app.imggen.ai/v1/remove-background に POST します。レスポンスは JSON です。base64 の image フィールドをデコードして、ディスクやオブジェクトストレージに書き込んでください。動作する cURL・Node.js・Python の例はこのページにあります。
- 成功 1 回につき 1 クレジット。API の中でもっとも安いエンドポイントです。Starter は月 400 クレジットで 9.99 ドル、つまり背景除去およそ 400 回分、Pro は 1,400 クレジットで 29.99 ドルです。購読中は未使用クレジットが繰り越され、失敗した呼び出しは自動返金されるため、返ってきた画像の分だけが請求されます。
- アカウントを作れば、クレジットカードなしで 50 クレジット分の無料枠を使って AI ツールを試せます。API アクセスは有料の Starter・Pro プランに含まれます。恒久的な無料 API 枠はなく、あとから静かに制限をかけるものを宣伝するより、はっきりそう申し上げます。
- API は 1 枚あたり最大 25 MB の JPEG（JPG）、PNG、WebP ファイルを受け付けます。結果は JSON レスポンス内に base64 エンコードされた画像として返されます。
- いいえ。この API はステートレスです。プロジェクトを作成することも、ファイルを保存することも、あなたの画像を保持することもありません。アップロードされたファイルは一時オブジェクトに書き込まれ、処理後、レスポンスを返すと同時に削除されます。残るのは、呼び出しが行われたことと消費クレジット数を記録した利用ログだけです。あなたの画像がモデルの学習に使われることは一切ありません。
- はい。無料プランを含むすべてのプランに完全な商用利用権が付いており、出力にウォーターマークは一切入りません。API が返したものは自由に販売、印刷、公開できます。
- このエンドポイントは透過 PNG を返すので、新しい色・グラデーション・背景の合成はご自身のパイプラインで行えます。2 回目の API 呼び出しは不要です。自前の素材ではなく AI 生成の背景が欲しい場合は、ImgGen の Web エディターに背景ジェネレーターもあります。
はじめる
背景除去 API を呼び出してみる
キー 1 つで 7 つのエンドポイントすべてが使えます。ウォーターマークなし、完全な商用利用権付き、そして送信したものはレスポンス後に一切保存されません。
API キーを取得