イメージ・モデレーション
OCI Generative AI Guardrailsでイメージのモデレーションを使用して、安全でないコンテンツのイメージを評価します。
イメージ・モデレーションは、既存のコンテンツ・モデレーション機能をイメージ入力に拡張します。Guardrailsシステム・バージョン1.1.0以降では、ApplyGuardrails APIを使用して、テキストとイメージの両方を含むスタンドアロン・イメージまたはマルチモーダル・リクエストを評価できます。
イメージ・モデレーションは、ユーザーがアップロードしたイメージ、生成されたイメージ、スクリーン・ショットおよび埋込みテキストを含むイメージ内の安全でないコンテンツを識別するのに役立ちます。
バージョンの選択については、Version Selection Workflowを参照してください。共有リクエスト構成については、「ApplyGuardrails APIの使用」を参照してください。
イメージ入力の使用
イメージ・コンテンツを評価するには、inputのかわりにmultimodalInputを使用し、イメージ・モデレーションをサポートするGuardrailsシステム・バージョン(1.1.0以降のバージョンなど)を指定します。
リクエストには、イメージのみのコンテンツ、またはテキストとイメージの組合せを含めることができます。テキスト・コンテンツとイメージ・コンテンツの両方が同じリクエストに含まれている場合、各モダリティは個別に評価されます。
multimodalInputフィールドには、次のtype値を持つアイテムを含めることができます。
TEXTIMAGE
サポートされるイメージ形式は次のとおりです。
- JPEG
- PNG
- WebP
1つのリクエストに最大5つのイメージを含めることができます。イメージとともにテキストを使用する場合は、multimodalInputに1つのTEXTアイテムのみを含めます。複数のテキスト値がある場合は、リクエストを送信する前に、それらを1つのTEXTアイテムに結合します。
モデレート結果
イメージ・モデレーションでは、別個のイメージ・モデレーション・レスポンス・オブジェクトは導入されません。かわりに、イメージ・モデレーション結果は、既存のOVERALLスコアを含む既存のcontentModeration結果の一部として返されます。
flaggedModalitiesフィールドは、モデレーション結果に検出または寄与した入力モダリティを識別します。
サポートされているモダリティ値は次のとおりです。
TEXTIMAGE
たとえば、安全でないコンテンツがイメージでのみ検出された場合、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万ピクセルを超えています | イメージ・サイズが最大ピクセル制限を超えています。 | イメージのサイズを変更し、リクエストを再送信します。 |