イメージ・モデレーション

OCI Generative AI Guardrailsでイメージのモデレーションを使用して、安全でないコンテンツのイメージを評価します。

イメージ・モデレーションは、既存のコンテンツ・モデレーション機能をイメージ入力に拡張します。Guardrailsシステム・バージョン1.1.0以降では、ApplyGuardrails APIを使用して、テキストとイメージの両方を含むスタンドアロン・イメージまたはマルチモーダル・リクエストを評価できます。

イメージ・モデレーションは、ユーザーがアップロードしたイメージ、生成されたイメージ、スクリーン・ショットおよび埋込みテキストを含むイメージ内の安全でないコンテンツを識別するのに役立ちます。

バージョンの選択については、Version Selection Workflowを参照してください。共有リクエスト構成については、「ApplyGuardrails APIの使用」を参照してください。

イメージ入力の使用

イメージ・コンテンツを評価するには、inputのかわりにmultimodalInputを使用し、イメージ・モデレーションをサポートするGuardrailsシステム・バージョン(1.1.0以降のバージョンなど)を指定します。

リクエストには、イメージのみのコンテンツ、またはテキストとイメージの組合せを含めることができます。テキスト・コンテンツとイメージ・コンテンツの両方が同じリクエストに含まれている場合、各モダリティは個別に評価されます。

multimodalInputフィールドには、次のtype値を持つアイテムを含めることができます。

  • TEXT
  • IMAGE

サポートされるイメージ形式は次のとおりです。

  • JPEG
  • PNG
  • WebP

1つのリクエストに最大5つのイメージを含めることができます。イメージとともにテキストを使用する場合は、multimodalInputに1つのTEXTアイテムのみを含めます。複数のテキスト値がある場合は、リクエストを送信する前に、それらを1つのTEXTアイテムに結合します。

モデレート結果

イメージ・モデレーションでは、別個のイメージ・モデレーション・レスポンス・オブジェクトは導入されません。かわりに、イメージ・モデレーション結果は、既存のOVERALLスコアを含む既存のcontentModeration結果の一部として返されます。

flaggedModalitiesフィールドは、モデレーション結果に検出または寄与した入力モダリティを識別します。

サポートされているモダリティ値は次のとおりです。

  • TEXT
  • IMAGE

たとえば、安全でないコンテンツがイメージでのみ検出された場合、OVERALLカテゴリには次のものが含まれます。

"flaggedModalities": ["IMAGE"]

テキスト・コンテンツとイメージ・コンテンツの両方がモデレーション結果に寄与する場合、レスポンスには両方のモーダリティが含まれます。

"flaggedModalities": ["TEXT", "IMAGE"]

返されたコンテンツ・モデレーション結果を使用して、検出のロギング、警告ユーザー、ブロック・リクエストなどのアクションをアプリケーションで実行します。

イメージ・モデレーションの制限および検証

イメージ入力は、イメージ・トークンのスロットルに従います。デフォルトのイメージトークンの制限は、約 200,000イメージトークン/分です。さらに必要な場合は、サービス制限の引き上げをリクエストします。

各イメージ入力には、最大1億7,000万ピクセルを含めることができます。イメージ・モデレーション・リクエストは、処理前に検証されます。multimodalInputがサポートされている入力要件を満たさない場合、リクエストが失敗することがあります。

条件 エラー詳細 処理
5つ以上のイメージが提供されています Guardrails APIは、multimodalInputで5つ以上のイメージをサポートしていません。 1つのリクエストで最大5つのイメージを送信できます。
イメージを含むmultimodalInputに複数のTEXT項目が指定されています 複数のテキスト入力とイメージはサポートされていません。 リクエストを送信する前に、すべてのテキストを1つのTEXTアイテムに結合します。
選択したGuardrailsシステム・バージョンはイメージ・モデレーションをサポートしていません ガードレール・バージョンがないか、指定されたバージョンにイメージ・モデレーション・サポートが含まれていません。 guardrailVersionConfigを含めて、guardrailVersionを1.1.0またはそれ以降のサポートされるバージョンに設定します。
イメージ入力が1億7,000万ピクセルを超えています イメージ・サイズが最大ピクセル制限を超えています。 イメージのサイズを変更し、リクエストを再送信します。