使い慣れたHTTPリクエストは移行の出発点です。本番切り替え前に、このチェックリストで画像と連携処理をテストしてください。
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
curl --fail-with-body --max-time 180 \
-H 'X-API-Key: YOUR_API_KEY' \
-F 'image_file=@image.jpg' \
-F 'size=auto' \
'https://removebgtool.net/v1.0/removebg' -o no-bg.png3. テスト前にパラメータを対応付け
互換性はリクエスト形式の対応を指し、同じ切り抜き結果を意味しません。typeはauto、type_levelはnone、channelsはrgbaに限ります。未対応のパラメーターに空でない値を指定すると、無視せずエラーにします。
| リクエスト項目 | 本サービスの対応 |
|---|---|
| image_file / image_url / image_file_b64 | image_file、image_url、image_file_b64のいずれか1つ。 |
| format | auto、png、jpg、webpに対応。ZIPは未対応です。 |
| size | ピクセル数の上限は形式によって異なります。サイズ表と出力制限をご確認ください。 |
| crop / bg_color | crop=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とは独立しています。パラメーター名だけでなく、動作も確認してください。