RemoveBGRemoveBG
← API

remove.bg APIの連携を移行する

エンドポイント、対応パラメータ、レスポンス処理、課金を確認します。代表的な画像でテストし、元に戻す手段を用意してから段階的に切り替えてください。

最終更新:

ドキュメントを見るAPIキーを取得 移行ガイドを見る

使い慣れたHTTPリクエストは移行の出発点です。本番切り替え前に、このチェックリストで画像と連携処理をテストしてください。

本番APIはCloudflare上で公開中です。D1がクレジットを原子的に予約し、非公開R2が再試行用の結果を保存し、Cloudflare Imagesは指定された後処理にのみ使用されます。

移行チェックリスト

1. 使用中のリクエストを確認

入力方法、出力形式、サイズ、編集パラメーターを整理します。ファイル、HTTPS URL、通常のbase64に対応していますが、remove.bgの全オプションを実装しているわけではありません。キーはサーバーで管理し、API対応プランで新しく作成してください。

2. エンドポイントとキーを変更

対応HTTPリクエストは構造を保ち、接続先とX-API-Keyを変更します。ライブラリ内でremove.bgのホスト名が固定されている場合は、上書き機能かHTTPクライアントを使ってください。remove.bgのキーを本サービスに送信しないでください。

- POST https://api.remove.bg/v1.0/removebg
+ POST https://removebgtool.net/v1.0/removebg

X-API-Key: YOUR_NEW_API_KEY
# Generate one ID per image; reuse it when retrying this request.
REQUEST_ID="$(uuidgen)"
curl --fail-with-body --max-time 180 \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H "Idempotency-Key: $REQUEST_ID" \
  -F 'image_file=@image.jpg' \
  'https://removebgtool.net/v1.0/removebg' -o no-bg.png

3. テスト前にパラメータを対応付け

互換性はリクエスト形式の対応を指し、同じ切り抜き結果を意味しません。typeはauto、type_levelはnone、channelsはrgbaに限ります。未対応のパラメーターに空でない値を指定すると、無視せずエラーにします。

リクエスト項目本サービスの対応
image_file / image_url / image_file_b64image_file、image_url、image_file_b64のいずれか1つ。
formatauto、png、jpg、webpに対応。ZIPは未対応です。
sizeピクセル数の上限は形式によって異なります。サイズ表と出力制限をご確認ください。
crop / bg_colorcrop=true/falseとbg_colorに対応。
type / type_level / channelsそれぞれauto / none / rgbaのみ。
bg_image_url / shadow / roi / crop_margin / scale / position背景画像、影、ROI、トリミング余白、拡大縮小、位置指定は未対応です。

4. レスポンスと課金を確認

保存前にContent-Typeを確認します。既定では画像バイト列、指定時はresult_b64を含むJSONが返ります。X-Credits-ChargedとX-Request-IDを確認してください。クレジットは本サービスのアカウントに属し、remove.bgのキーや残高は移せません。プレビューとフル解像度の1画像あたりの料金は同じです。

5. 代表的な画像セットでテスト

商品、人物、低コントラストの画像、各出力形式に加え、サイズ超過、無効なキー、未対応パラメーター、残高不足をテストします。409、429、タイムアウト、処理失敗への対応を確認し、調査用にリクエストIDを残してください。

任意のIdempotency-Keyを指定できます。同じキー・画像・パラメーターなら、成功結果を10分間は追加課金なしで再取得できます。再取得では元のX-Credits-Chargedを返し、X-Idempotent-Replayed: trueが付きます。処理中は409です。失敗・期限切れのキーも予約状態のままなので、新たな課金対象リクエストには別のキーを使ってください。未指定なら各リクエストは独立します。クライアントのタイムアウトは180秒を確保してください。

6. 段階的に切り替え、切り戻し手段を用意

まず一部の処理だけを新しい連携へ流し、成功率、画質、クレジットを確認します。要件を満たしてから流量を増やし、検証中は以前の設定も残してください。トラフィックの振り分けとロールバックはアプリ側で管理するもので、本サービスの自動切り替え機能ではありません。

背景削除のよくある質問

remove.bg API をそのまま置き換えられますか？

いいえ。RemoveBG は image_file、image_url、image_file_b64 を受け付けますが、初期値と対応する編集パラメーターが異なります。各項目と実際の応答を確認してください。

remove.bg の API キーを再利用できますか？

いいえ。RemoveBG のアカウントを作成し、API Keys で別のキーを発行してください。旧アカウント、残高、キーは引き継がれません。

現在の環境へ有料 HD API の本番通信を送れますか？

はい。本番APIは公開中です。RemoveBG APIキーを作成し、対応するパラメーターと出力をテストしてから段階的に切り替えてください。

remove.bg公式APIリファレンス · 元資料の確認日：2026年9月24日

RemoveBG は独立したサービスで、remove.bg、Canva、Leonardo.Ai とは提携していません。既存のアカウント、クレジット、API キーは移行できません。