imgix APIsレンダリング API背景背景置換

背景置換

bg-replace

プレミアム機能

背景置換は現在、プレミアムプランのimgix顧客に提供されています。この機能に興味がある場合は、営業チームにお問い合わせくださいして、この機能についての詳細情報を入手してください。

背景置換パラメーター(bg-replace)は、文字列プロンプト値を受け入れます。プロンプトに基づいて、bg-replaceは写真内の被写体または物体を識別し、プロンプトに基づいて背景を置換します。

以下は、ランナーの元の画像の例です:

ランナーの元の写真

bg-replace=in%20desertを適用すると、背景置換APIが元の背景をプロンプト(in desert)で置き換えます:

砂漠のランナーの修正写真

対応画像サイズと解像度

12メガバイト以上または50メガピクセルを超える画像は、デフォルトで背景置換のために最適化されます。

推奨事項

  • 良い照明と前景と背景の間の高いコントラストがある画像が背景置換に最適です。
  • ぼやけたり単色の背景が好まれます。
  • 前景が鮮明な画像を使用してください。ぼやけた前景は置換される可能性があります。
  • 商品画像では、商品全体が見え、切れていない状態であるべきです。
  • 主な被写体または商品は焦点を合わせるべきです。
  • 固い影や反射を避けてください。
  • 自然で目線の角度が最適です。

前処理

背景置換は時間がかかるプロセスです。キャッシュを温めることによって、知覚されるパフォーマンスを向上させることができます。これは、画像を公開する前に背景置換APIへのレンダリングリクエストを発行することによって行うことができます。

失敗の取り扱い

bg-replaceが失敗した場合、デフォルトでは元の画像を返します。この動作はbg-replace-fallbackを使用して制御することができます。

さらに、応答には追加のヘッダーが含まれます:

X-Imgix-Bg-Replace-Failure-Reason

非同期応答

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

この一時的な応答には以下のヘッダーも含まれます:

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

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

AI変換の連鎖

レンダリングAPIは、複数のAI変換を非同期で処理し、完了するまでに数秒かかります。複数のAI変換が存在する場合、次の順序でレンダリングされます:

AI変換を連鎖させる方法については、このチュートリアルをご覧ください。

AI変換の連鎖

ご質問やフィードバックがある場合は、アカウントマネージャーまたはsupport@imgix.comまでご連絡ください。