imgix APIs
レンダリング API
背景
背景削除

背景削除

bg-remove

プレミアム機能

背景削除は現在、imgixのプレミアムプランを利用するお客様にのみ利用可能です。この機能に興味がある場合は、弊社の営業チーム (opens in a new tab)にお問い合わせください。

背景削除パラメーターを使用すると、異なる背景を持つ画像を提供できます。背景が除去されると、画像を変換したり他の画像と組み合わせたりできます。

サポートされる画像フォーマット

デフォルトで以下のオリジン画像フォーマットをサポートしています。

  • JPEG
  • PNG
  • WEBP
  • HEIF/HEIC
  • TIFF

imgixで提供できるサポートされている画像フォーマットの完全なリストについては、imgixで提供できる画像フォーマットを参照してください。

サポートされる画像サイズと解像度

12メガバイト以上または50メガピクセルを超える画像は、デフォルトで背景削除の最適化が行われます。

出力画像は10メガピクセルの制限があり、この制限内に収まるようにリサイズされます。（例：8000x5000ピクセルの入力画像は4000x2500ピクセルにリサイズされます。）

パラメーターの使用方法

このパラメーターを適用するには、画像URLに bg-remove=true を追加します。背景削除には最大1分かかる場合がありますが、ほとんどのリクエストは数秒で完了します。背景削除が完了すると、リクエストはキャッシュされ、その後のリクエストははるかに高速な応答時間で返されます。

例：背景が除去された画像

背景が除去された女性の笑顔

bg-removeと他のパラメータの組み合わせ

bg-removeを使用して、創造的な方法で画像を再作成することができます。例えば、透明部分を新しい色で塗りつぶすことができます：

背景が埋められた女性の笑顔

背景を別の画像で置き換えるために、ウォーターマークを使用することもできます：

ウォーターマークとして使用された女性の笑顔

推奨事項

  • 背景削除に最適な画像は、良好な照明と前景と背景の間の高いコントラストを持つものです。
  • ぼやけた背景や単色の背景が好まれます。
  • ぼやけた前景が除去される場合があるため、鮮明な前景の画像を使用してください。
  • 商品画像の場合、商品全体が見えるようにしてください。
  • 主要な被写体や商品が焦点に合っている必要があります。
  • 強い影や反射を避けてください。
  • 自然で目線の高さのアングルが最適です。

注意事項

前処理

背景削除は時間のかかる処理です。お客様が要求したときに背景が除去された画像が準備されるようにするには、背景を除去することを決定した直後に、bg-remove=true を使用してimgixレンダリングAPIにリクエストを送信してください。

エッジケースの処理

背景削除はデフォルトで優雅に失敗します。背景削除が何らかの理由で失敗した場合、オリジン画像がその代わりに提供されます。この動作をオーバーライドするには、bg-remove-fallback=false を設定してください。

X-Imgix-Bg-Remove-Failure-Reason ヘッダーには、失敗の理由が詳細に記述されます。このヘッダーは、bg-remove-fallback=false が有効または無効である場合に存在します。

注意: 画像を置換または再処理するには、パージリクエストが必要です。

非同期レスポンス

フォールバックが有効な場合

多くのリクエストでは、背景が初めて削除されると、数秒以内に結果が返されます。負荷が高い時には、リクエストを処理中の一時的な応答が返されることがあります。この一時的な応答は、bg-remove-fallback=falseが設定されている場合は200のステータスコードまたは423のエラーを送信します。bg-remove-fallbackの設定に関わらず、キャッシュされた応答は短い間隔に設定され、要求された背景削除画像が返されるようになります。

この一時的な応答には、次のヘッダーも含まれます。

X-Imgix-Bg-Remove-Failure-Reason: Processing background removal request.

処理済みの画像が失敗ヘッダーなしで受信されるまで、リクエストを再試行し続けることができます。その後のすべてのリクエストでは、背景が削除された画像が返されます。

質問

ご質問やフィードバックがある場合は、アカウントマネージャーまたはサポートまでお問い合わせください。

背景背景削除のフォールバック