画像モデレーション V2.0 同期検出 API - AI Guardrails - Alibaba Cloud ドキュメントセンター

API の概要

Image Moderation 2.0 API は、コンテンツ規制に違反したり、プラットフォームを混乱させたり、ユーザーエクスペリエンスを低下させたりする画像を検出します。 40+ 種類のリスクラベルと 40+ 種類のリスク管理をサポートしています。 Image Moderation 2.0 は、プラットフォームのポリシーに応じた画像のレビューまたはモデレート用に、リスクラベルと信頼度スコアを返します。 Image Moderation Pro 2.0：概要と課金。

利用開始

Alibaba Cloud アカウントへの登録: 登録。
Content Moderation の従量課金を有効化: サービスを有効化。有効化は無料で、使用量は自動的に課金されます (課金)。
AccessKey の作成：RAM を使用して AccessKey を作成します。RAM ユーザーの AccessKey を使用する場合、Alibaba Cloud アカウントから RAM ユーザーに AliyunYundunGreenWebFullAccess 権限を付与してください。RAM 認可。
SDK を使用して統合します。画像モデレーション - 拡張 (2.0) SDK と統合ガイド。

注意事項

この API は、画像コンテンツモデレーションタスクを作成します。HTTP ネイティブコールガイドに従ってリクエストを構築するか、アクセスガイドのビルド済みサンプルを使用できます。

API オペレーション：ImageModeration

サポートされるリージョンとエンドポイント：

リージョン	パブリックエンドポイント	VPC エンドポイント	サポートされるサービスコード
シンガポール	green-cip.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com	postImageCheckByVL_global、baselineCheck_global、aigcDetector_global、faceDetect_global、faceDetect_pro_global
マレーシア (クアラルンプール)	green-cip.ap-southeast-3.aliyuncs.com	None
インドネシア (ジャカルタ)	green-cip.ap-southeast-5.aliyuncs.com	None
イギリス (ロンドン)	green-cip.eu-west-1.aliyuncs.com	None
中国 (香港)	green-cip.cn-hongkong.aliyuncs.com	green-cip-vpc.cn-hongkong.aliyuncs.com	postImageCheckByVL_global
米国 (バージニア)	green-cip.us-east-1.aliyuncs.com	green-cip-vpc.us-east-1.aliyuncs.com	baselineCheck_global、aigcDetector_global
米国 (シリコンバレー)	green-cip.us-west-1.aliyuncs.com	None
ドイツ (フランクフルト)	green-cip.eu-central-1.aliyuncs.com	green-cip-vpc.eu-central-1.aliyuncs.com

API 呼び出しで指定したエンドポイントによって、Content Moderation が画像をダウンロードしてモデレーションする場所が決まります。コンソールでサービスを有効化したリージョンは、モデレーションの場所を決定しません。たとえば、green-cip.us-west-1.aliyuncs.com を呼び出すと、Content Moderation は米国 (シリコンバレー) リージョンで画像をダウンロードしてモデレーションします。ネットワーク遅延を減らすために、ご利用のアプリケーションサーバに近いエンドポイントを選択してください。

画像モデレーション 2.0 API は、green-cip.{regionId}.aliyuncs.com という形式のエンドポイント (例：green-cip.cn-shanghai.aliyuncs.com) を使用します。Content Moderation 1.0 の設定エンドポイント green.{regionId}.aliyuncs.com でこの API を呼び出さないでください。呼び出した場合、リクエストは失敗します。

イギリス (ロンドン)、マレーシア (クアラルンプール)、インドネシア (ジャカルタ) リージョンは、シンガポールリージョンのコンソール設定を再利用します。米国 (シリコンバレー) リージョンは、米国 (バージニア) リージョンのコンソール設定を再利用します。

グローバル版サービス (_cb サフィックスが付くもの、例：baselineCheck_cb) は、シンガポールや米国などの国際リージョンにデプロイされており、海外の画像モデレーションシナリオ向けです。中国本土からグローバル版のエンドポイントを呼び出すと、国際ネットワークリンクを経由するため、中国リージョンを呼び出すよりも大幅に遅延が大きくなります。ビジネスが主に中国本土のユーザーを対象としている場合は、対応する標準サービスを中国リージョンで呼び出してください。たとえば、中国 (上海) エンドポイント green-cip.cn-shanghai.aliyuncs.com です。

課金：
課金対象です。HTTP ステータスコード 200 のリクエストのみが課金され、失敗したリクエストは課金されません。この API は、マルチサービス同期検出 API を通じて、1 回のリクエストでマルチシナリオ検出をサポートします。ビジネスシナリオに必要な Service 値のみを指定し、固定のフルセットのチェックは指定しないでください。リクエストで検出された各 Service は、それぞれの価格で個別に課金されます。課金。
画像要件：
- サポートされるフォーマットは、PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、AVIF です。HEIF 画像の場合、長辺は 8,192 ピクセルを超えることはできません。GIF の場合、最初のフレームのみが処理されます。ICO ファイルの場合、最後の画像のみが処理されます。
- 画像は 20 MB を超えてはなりません。高さまたは幅は 30,000 ピクセルを超えることはできず、総ピクセル数は 2.5 億を超えることはできません。最適なパフォーマンスを得るには、画像の解像度を 200 × 200 ピクセル以上にすることを推奨します。解像度が低いと、アルゴリズムのパフォーマンスが低下する可能性があります。
- 画像は 3 秒以内にダウンロードを完了する必要があります。そうでない場合、リクエストはタイムアウトし、エラーが返されます。

QPS 制限

デフォルトの制限：ユーザーあたり 100 QPS。この制限を超えると、スロットリングがトリガーされます。制限を引き上げるには、アカウントマネージャーにお問い合わせください。

デバッグ

アプリケーションに統合する前に、画像審査 API を、Alibaba Cloud OpenAPI を通じてオンラインでデバッグできます。このポータルでは、コード例、SDK の依存関係、およびパラメータードキュメントが提供されています。

重要

デバッグコールはご利用のアカウントを使用し、課金対象の使用量としてカウントされます。

リクエストパラメーター

cURL 呼び出しやネイティブ HTTP リクエストの構築には、AccessKey 認証情報を使用し、必須の共通パラメーター AccessKeyId、Signature、Timestamp を含め、署名を計算してください。これらのパラメーターは、ビジネスパラメーター Service と ServiceParameters に加えて必須です。省略した場合、API はリクエストを拒否します。clientInfo パラメーターはオプションのビジネスコンテキストを提供し、必須ではありません。必須の共通リクエストパラメーターの完全なリストについては、「共通パラメーター」をご参照ください。

リクエストボディは、以下のフィールドを含む JSON オブジェクトです：

パラメーター

タイプ

必須

例

説明

Service

String

はい

baselineCheck_global

使用する画像モデレーション 2.0 サービス。有効な値:

postImageCheckByVL_global: 大小モデル融合画像審査サービス
baselineCheck_global: 汎用ベースライン検出
aigcDetector_global: AIGC 生成画像の判定

説明

サービス間の違いの詳細については、「サービスの説明」をご参照ください。 AIGC 固有のサービスについては、「AIGC シナリオ検出サービス」をご参照ください。グローバルエディションは、国際リージョンでのみ使用できます。

画像のシナリオに基づいて Service を選択します：アバター画像には profilePhotoCheck、投稿画像には postImageCheck、マーケティング資料には advertisingCheck、汎用モデレーションには baselineCheck を使用します。より高いモデレーション品質が要求されるシナリオでは、postImageCheckByVL を優先してください。

ServiceParameters

JSONString

はい

JSON 文字列としてのコンテンツモデレーションパラメーター。「ServiceParameters」をご参照ください。

表 1. ServiceParameters

パラメーター	タイプ	必須	例	説明
imageUrl	String	はい。次の 3 つの方法のいずれかを使用して画像を指定します： `imageUrl` パラメーターを指定して画像 URL を使用します。 `ossBucketName`、`ossObjectName`、`ossRegionId` パラメーターを指定して OSS 権限付与を使用します。ローカル画像を使用します。ローカル画像をアップロードして検出する場合、ご利用の OSS ストレージは使用されず、ファイルは 30 分間のみ保存されます。SDK を使用すると、ローカル画像をアップロードできます。コードサンプルについては、「画像モデレーション 2.0 (拡張版) の SDK と統合ガイド」をご参照ください。	https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png	モデレーション対象の画像の URL。URL はパブリックにアクセス可能で、長さが 2,048 文字を超えてはなりません。説明 URL には中国語の文字を含めることはできません。1 つのリクエストにつき、1 つの URL のみ指定できます。この方法を使用したリクエストがタイムアウトする場合は、代わりに OSS 権限付与方法を使用してください。
ossBucketName	String		bucket_01	権限が付与された OSS バケットの名前。説明内部 OSS 画像 URL を使用するには、まずクラウドリソースアクセス認可ページで Alibaba Cloud アカウント (root ユーザー) を使用して AliyunCIPScanOSSRole 権限を付与する必要があります。 OSS 権限付与を使用して画像を送信した場合でも、Content Moderation は画像の信頼性とアクセシビリティを検証するために元の画像 URL を取得することがあります。オリジンサーバーがホットリンク保護のために HTTP 403 を返す場合は、ドキュメントに記載されている Content Moderation サービスのドメインまたは IP 範囲をホットリンク保護ホワイトリストに追加するか、テストのために一時的にホットリンク保護を無効にしてください。ワイルドカード `*.aliyuncs.com` のみに依存せず、ドキュメントに記載されている特定のドメインまたは IP 範囲を設定してください。
ossObjectName	String		2022023/04/24/test.jpg	権限が付与された OSS バケット内のオブジェクトの名前。説明 1. 元の OSS オブジェクト名を指定してください。名前に画像処理パラメーターを追加することはサポートされていません。画像処理パラメーターを追加するには、imageUrl パラメーターを使用してください。 2. オブジェクト名に中国語の文字やスペースが含まれている場合は、URL エンコードせずに名前をそのまま指定してください。
ossRegionId	String		cn-beijing	OSS バケットが配置されているリージョン。
dataId	String	いいえ	img123****	モデレーション対象のオブジェクトの一意の ID。この ID を使用してビジネスデータを追跡します。ID は最大 64 文字で、大文字と小文字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。
referer	String	いいえ	www.aliyun.com	ホットリンク保護などのシナリオで使用される `Referer` リクエストヘッダー。値は最大 256 文字です。
infoType	String	はい	customImage,textInImage	取得する補足情報。有効な値： customImage：カスタム画像ライブラリのヒット情報 textInImage：画像内テキスト。電話番号、WeChat ID、QQ ID などの連絡先情報を識別するには、`infoType` に `textInImage` を含めます。サービスは、このトラフィック誘導情報を、独立した電話番号ラベルではなく、`pt_toDirectContact_tii` のような広告トラフィック誘導ラベルとして返します。 publicFigure：公人情報 logoData：ロゴ情報複数の値をカンマ (,) で区切って指定できます。たとえば、`customImage,textInImage` は、カスタム画像ライブラリのヒット情報と画像からのテキストの両方を返します。説明公人およびロゴ情報は、高度な画像モデレーションサービスでのみ返されます。サービス説明。

返却データ

パラメーター	タイプ	値の例	説明
RequestId	String	70ED13B0-BC22-576D-9CCF-1CC12FEAC477	トラブルシューティング用の一意のリクエスト識別子。
Data	Object		画像コンテンツモデレーションの結果。Data。
Code	Integer	200	ステータスコード。コードの説明。
Msg	String	OK	応答メッセージ。

表 2. Data

パラメーター	タイプ	例	説明
Result	Array		リスクラベルや信頼度スコアを含む画像検出結果。詳細については、「result」をご参照ください。
RiskLevel	String	high	画像のリスクレベル。最もリスクの高いラベルによって決定されます。指定可能な値は次のとおりです： high：高リスク medium：中リスク low：低リスク none：リスク検出なし説明高リスクのコンテンツには直ちに対処してください。中リスクのコンテンツは手動でレビューしてください。低リスクのコンテンツについては、高い再現率が必要な場合にのみ対処し、それ以外の場合はリスクなしとして扱ってください。Content Moderation コンソールでリスクのしきい値を設定できます。
DataId	String	img123******	リクエストで指定されたデータオブジェクトの一意の ID。説明リクエストで DataId を提供した場合、このフィールドで同じ値が返されます。
Ext	Object		画像の追加参照情報。詳細については、「追加情報」をご参照ください。

表 3. Result

パラメーター	タイプ	値の例	説明
Label	String	violent_explosion	検出されたコンテンツのラベル。1 つの画像に複数のラベルが付くことがあり、それぞれに対応する信頼度スコアがあります。サポートされているラベルのリストについては、以下をご参照ください： baselineCheck_global でサポートされているラベル説明 Content Moderation LLM サービスに関連するラベルについては、「Content Moderation LLM サービスのリスクラベル用語集」をご参照ください。
Confidence	Float	81.22	ラベルの信頼度スコア。0 から 100 のスケールで表されます。値は小数点以下 2 桁まで正確です。一部のラベルは信頼度スコアを返しません。詳細については、「リスクラベル用語集」をご参照ください。
Description	String	Fireworks-related content	`Label` 値の人間が判読可能な説明。重要この説明は表示目的のみであり、変更される可能性があります。自動化のためには、Label フィールドに依存してください。
RiskLevel	String	high	設定したしきい値に基づく、ラベルに関連付けられたリスクレベル。指定可能な値： high：高リスク medium：中リスク low：低リスク none：リスク検出なし

追加情報

表 4. Ext

パラメーター	タイプ	値の例	説明
CustomImage	JSONArray		カスタム画像ライブラリで一致が見つかった場合、このパラメーターには一致したライブラリに関する情報が含まれます。詳細については、「CustomImage」をご参照ください。
TextInImage	Object		画像内で認識されたテキストに関する情報を返します。詳細については、「TextInImage」をご参照ください。
PublicFigure	JSONArray		画像内で公人が検出された場合、このパラメーターはその人物に関する情報を返します。詳細については、「PublicFigure」をご参照ください。
LogoData	JSONArray		一致したロゴデータを返します。詳細については、「LogoData」をご参照ください。

表 5. CustomImage

パラメーター	タイプ	値の例	説明
LibId	String	lib0001	一致したカスタム画像ライブラリの ID。
LibName	String	カスタム画像ライブラリ A	一致したカスタム画像ライブラリの名前。
ImageId	String	20240307	一致したカスタム画像の ID。

表 6. TextInImage

パラメーター	タイプ	値の例	説明
OcrResult	JSONArray		画像内で認識された各テキスト行に関する情報。詳細については、「OcrResult」をご参照ください。
RiskWord	StringArray	[ "リスクワード 1", "リスクワード 2"]	テキスト内で一致したリスクワード。`tii` ラベルが一致した場合に返されます。
CustomText	JSONArray		カスタムテキストライブラリで一致が見つかった場合、このパラメーターには一致したライブラリに関する情報が含まれます。詳細については、「CustomText」をご参照ください。

表 7. OcrResult

パラメーター	タイプ	値の例	説明
Text	String	認識されたテキスト行 1	画像内で認識されたテキスト行の内容。

表 8. CustomText

パラメーター	タイプ	値の例	説明
LibId	String	test20240307	一致したカスタムテキストライブラリの ID。
LibName	String	カスタムテキストライブラリ A	一致したカスタムテキストライブラリの名前。
KeyWords	String	カスタムキーワード 1	一致したカスタムキーワード。

表 9. PublicFigure

パラメーター	タイプ	値の例	説明
FigureName	String	田中一郎	認識された公人の名前。
FigureId	String	xxx001	認識された公人の人物 ID。説明一部の公人は `FigureId` で識別され、他の公人は `FigureName` のみで識別されます。`FigureName` パラメーターを最初に確認し、`FigureName` が空の場合は `FigureId` パラメーターを確認することをお勧めします。
Location	JSONArray		公人の位置。詳細については、「Location」をご参照ください。

表 10. LogoData

パラメーター	タイプ	値の例	説明
Logo	JSONArray		ロゴに関する情報。詳細については、「Logo」をご参照ください。
Location	Object		ロゴの位置。詳細については、「Location」をご参照ください。

表 11. Logo

パラメーター	タイプ	値の例	説明
Name	String	DingTalk	ロゴの名前。
Label	String	logo_sns	一致したラベル。
Confidence	Float	88.18	信頼度スコア。

表 12: ロケーション

パラメーター	タイプ	値の例	説明
X	Float	41	画像の左端からのバウンディングボックスの左上隅の x 座標 (ピクセル単位)。
Y	Float	84	画像の上端からのバウンディングボックスの左上隅の y 座標 (ピクセル単位)。
W	Float	83	バウンディングボックスの幅 (ピクセル単位)。
H	Float	26	バウンディングボックスの高さ (ピクセル単位)。

例

リクエスト例

{
    "Service": "baselineCheck_global",
    "ServiceParameters": {
        "imageUrl": "https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png",
        "dataId": "img123****"
    }
}

レスポンス例

リスクコンテンツが検出された場合のレスポンス

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "pornographic_adultContent",
                "Confidence": 81,
                "Description": "Adult Content"
            },
            {
                "Label": "sexual_partialNudity",
                "Confidence": 98,
                "Description": "Sexually Suggestive"
            },
            {
                "Label": "violent_explosion",
                "Confidence": 70,
                "Description": "Explosion"
            },
            {
                "Label": "violent_explosion_lib",
                "Confidence": 81,
                "Description": "Explosion (Custom Library)"
            }
        ],
        "RiskLevel": "high"
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

リスクコンテンツが検出されなかった場合のレスポンス

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "nonLabel",
                "Description": "No Risk Detected"
            }
        ],
        "RiskLevel": "none"
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

画像が画像許可リストに一致した場合のレスポンス

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "nonLabel_lib",
                "Confidence": 83,
                "Description": "Matched in Image Allowlist"
            }
        ],
        "RiskLevel": "none"
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

追加情報を含むレスポンス

カスタム画像ライブラリでの一致

{
    "Code": 200,
    "Data": {
        "DataId": "",
        "Ext": {
            "CustomImage": [
                {
                    "ImageId": "12345",
                    "LibId": "TEST20240307",
                    "LibName": "Risk Image Library A"
                }
            ]
        },
        "Result": [
            {
                "Confidence": 100.0,
                "Label": "pornographic_adultContent_lib",
                "Description": "Adult Content (Custom Library)"
            }
        ],
        "RiskLevel": "high"
    },
    "Msg": "success",
    "RequestId": "5F572704-4C03-51DF-8957-D77BF6E7444E"
}

カスタムテキストライブラリでの一致

{
    "Code": 200,
    "Data": {
        "DataId": "",
        "Ext": {
            "TextInImage": {
                "CustomText": [
                    {
                        "KeyWords": "custom keyword 1",
                        "LibId": "TEST20240307",
                        "LibName": "Text Blocklist A"
                    }
                ],
                "OcrResult": [
                    {
                        "Text": "Text line 1"
                    },
                    {
                        "Text": "Text line 2"
                    },
                    {
                        "Text": "Text line 3 containing a custom keyword"
                    }
                ],
                "RiskWord": null
            }
        },
        "Result": [
            {
                "Confidence": 99.0,
                "Label": "pornographic_adultContent_tii_lib",
                "Description": "Text Contains Pornographic Content (Custom Library)"
            }
        ],
        "RiskLevel": "high"
    },
    "Msg": "success",
    "RequestId": "TESTZGL-0307-2024-0728-FOREVER"
}

画像内テキスト違反

{
    "Code": 200,
    "Data": {
        "DataId": "",
        "Ext": {
            "TextInImage": {
                "CustomText": null,
                "OcrResult": [
                    {
                        "Text": "Text line 1"
                    },
                    {
                        "Text": "Text line 2"
                    },
                    {
                        "Text": "Text line 3 containing a risk word"
                    }
                ],
                "RiskWord": [
                    "risk word 1"
                ]
            }
        },
        "Result": [
            {
                "Confidence": 89.15,
                "Label": "political_politicalFigure_name_tii",
                "Description": "Text Contains the Name of a Political Figure"
            }
        ],
        "RiskLevel": "high"
    },
    "Msg": "success",
    "RequestId": "TESTZGL-0307-2024-0728-FOREVER"
}

検出されたロゴ情報

{
    "Code": 200,
    "Data": {
        "DataId": "",
        "Ext": {
            "LogoData": [
                {
                    "Location": {
                        "H": 44,
                        "W": 100,
                        "X": 45,
                        "Y": 30
                    },
                    "Logo": [
                        {
                            "Confidence": 96.15,
                            "Label": "pt_logotoSocialNetwork",
                            "Name": "CCTV"
                        }
                    ]
                }
            ]
        },
        "Result": [
            {
                "Confidence": 96.15,
                "Label": "pt_logotoSocialNetwork",
                "Description": "Social Media Platform Logo"
            }
        ],
        "RiskLevel": "high"
    },
    "Msg": "success",
    "RequestId": "TESTZGL-0307-2024-0728-FOREVER"
}

検出された公人情報

{
    "Code": 200,
    "Data": {
        "DataId": "",
        "Ext": {
            "PublicFigure": [
                {
                    "FigureId": null,
                    "FigureName": "Yang San",
                    "Location": [
                        {
                            "H": 520,
                            "W": 13,
                            "X": 14,
                            "Y": 999
                        }
                    ]
                }
            ]
        },
        "Result": [
            {
                "Confidence": 92.05,
                "Label": "political_politicalFigure_3",
                "Description": "Provincial or Municipal Government Personnel"
            }
        ],
        "RiskLevel": "high"
    },
    "Msg": "success",
    "RequestId": "TESTZGL-0307-2024-0728-FOREVER"
}

説明

例は読みやすさのためにフォーマットされています。実際のレスポンスは、改行やインデントのない単一行の文字列です。

リスクラベル

以下の表は、リスクラベル、その意味、および信頼度スコアの範囲を示しています。コンソール操作ガイドでラベルの切り替えや検出範囲の設定ができます。サービス別のサポートラベル：

シナリオ	サービスとラベル
一般シナリオ	ベースラインチェック (baselineCheck_global)
AIGC シナリオ	AI 生成画像検出 (aigcDetector_global)

リスクが検出されない場合、または画像が画像ホワイトリストに一致する場合に返されるラベルについては、「リスクなしまたはホワイトリスト登録済み画像のサポートラベル」をご参照ください。

説明

コンテンツガバナンスのために、システムから返されるリスクラベルと信頼度スコアを保存することをお勧めします。これらを使用して、手動レビューの優先順位付け、アノテーション、段階的かつ分類的なガバナンス措置を実施してください。

表 4. 一般ベースライン検出 (baselineCheck_global) のサポートタグ

ラベル	信頼度スコア	説明
pornographic_adultContent	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には成人向けのポルノコンテンツが含まれている可能性があります。
pornographic_cartoon	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはポルノ漫画のコンテンツが含まれている可能性があります。
pornographic_adultToys	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはアダルトグッズが含まれている可能性があります。
pornographic_art	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはポルノ芸術が含まれている可能性があります。
pornographic_adultContent_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストにポルノコンテンツが含まれています。
pornographic_suggestive_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに性的な示唆を含むコンテンツが含まれています。
pornographic_o_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに特別カテゴリのコンテンツが含まれています。詳細については、Content Moderation コンソールをご参照ください。
pornographic_organs_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに性器の記述が含まれています。
pornographic_adultToys_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストにアダルトグッズに関連するコンテンツが含まれています。
sexual_suggestiveContent	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には下品または性的に示唆的なコンテンツが含まれている可能性があります。
sexual_femaleUnderwear	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には下着や水着が含まれている可能性があります。
sexual_cleavage	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には女性の胸の谷間が写っている可能性があります。
sexual_maleTopless	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には上半身裸の男性が含まれている可能性があります。
sexual_cartoon	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には性的に示唆的な漫画のコンテンツが含まれている可能性があります。
sexual_shoulder	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には肩に関する性的に示唆的なコンテンツが含まれている可能性があります。
sexual_femaleLeg	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には脚に関する性的に示唆的なコンテンツが含まれている可能性があります。
sexual_pregnancy	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には妊娠や授乳に関連するコンテンツが含まれている可能性があります。
sexual_feet	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には足に関する性的に示唆的なコンテンツが含まれている可能性があります。
sexual_kiss	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはキスが含まれている可能性があります。
sexual_intimacy	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には親密な行動が含まれている可能性があります。
sexual_intimacyCartoon	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には漫画やアニメーションでの親密な行動が含まれている可能性があります。
violent_explosion	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には花火や爆発に関連する要素が含まれている可能性があります。詳細については、Content Moderation コンソールをご参照ください。
violent_burning	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	イメージには不適切なコンテンツが含まれている可能性があります。
violent_armedForces	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には武装勢力が含まれている可能性があります。
violent_weapon	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には武器が含まれている可能性があります。
violent_crowding	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には群衆が含まれている可能性があります。
violent_gun	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には銃器が含まれている可能性があります。
violent_knives	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはナイフが含まれている可能性があります。
violent_horrific	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には恐ろしいコンテンツが含まれている可能性があります。
violent_nazi	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはナチス関連のコンテンツが含まれている可能性があります。
violent_bloody	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には血まみれのコンテンツが含まれている可能性があります。
violent_extremistGroups_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストにテロ組織に関連するコンテンツが含まれています。
violent_extremistIncident_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストにテロ事件に関連するコンテンツが含まれています。
violence_weapons_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに銃器やナイフの記述が含まれています。
violent_ACU	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には戦闘服が含まれている可能性があります。
contraband_drug	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には薬物関連のコンテンツが含まれている可能性があります。
contraband_drug_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに違法薬物に関連するコンテンツが含まれています。
contraband_gamble	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはギャンブル関連のコンテンツが含まれている可能性があります。
contraband_gamble_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストにギャンブルに関連するコンテンツが含まれています。
inappropriate_smoking	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には喫煙関連のコンテンツが含まれている可能性があります。
inappropriate_drinking	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはアルコール関連のコンテンツが含まれている可能性があります。
inappropriate_tattoo	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはタトゥーが含まれている可能性があります。
inappropriate_middleFinger	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には中指を立てるジェスチャーが含まれている可能性があります。
inappropriate_foodWasting	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には食品廃棄物が含まれている可能性があります。
profanity_Offensive_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに、深刻な冒涜、言葉による攻撃、または不快なコンテンツが含まれています。
profanity_Oral_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストに口語的な冒涜が含まれています。
religion_clothing	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には特別なシンボルや要素が含まれている可能性があります。詳細については、Content Moderation コンソールをご参照ください。
religion_logo	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
religion_flag	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
religion_taboo1_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像内のテキストにタブーコンテンツが含まれています。詳細については、Content Moderation コンソールをご参照ください。
religion_taboo2_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
flag_country	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には旗関連のコンテンツが含まれている可能性があります。
political_historicalNihility	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には特定のコンテンツが含まれている可能性があります。詳細については、Content Moderation コンソールをご参照ください。
political_historicalNihility_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_politicalFigure_1	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_politicalFigure_2	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_politicalFigure_3	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_politicalFigure_4	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_politicalFigure_name_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_prohibitedPerson_1	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_prohibitedPerson_2	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_prohibitedPerson_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_taintedCelebrity	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_taintedCelebrity_tii	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_CNFlag	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_CNMap	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_logo	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_outfit	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
political_badge	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。
pt_logo	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像にはロゴが含まれている可能性があります。
QR code	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	画像には QR コードが含まれている可能性があります。
pt_custom_01	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	カスタムラベル 01。
pt_custom_02	0 から 100 のスコア。スコアが高いほど信頼度が高いことを意味します。	カスタムラベル 02。

説明

tii は text in image の略です。tii で終わるラベルは、非準拠のテキストをフラグ付けします。

各リスクラベルに対してカスタム画像ライブラリを設定することもできます。検出された画像がカスタム画像ライブラリ内の画像と酷似している場合、システムは対応するリスクラベルを _lib の形式で返します。たとえば、violent_explosion リスクラベルにカスタム画像ライブラリを設定し、検出された画像が酷似している場合、label パラメーターは violent_explosion_lib を返します。対応する confidence パラメーターは類似度スコアを表します。

システムが入力画像にリスクを検出しない場合、または画像が免除リストの画像と非常に類似している場合、返される label と confidence score は次の表で説明されています。

ラベル	信頼度スコア	説明
nonLabel	このフィールドは返されません。	イメージにリスクが検出されないか、すべての検出項目が無効になっています。詳細については、「Content Moderation コンソール」をご参照ください。
nonLabel_lib	0 から 100 のスコア。スコアが高いほど信頼度が高いことを示します。	このイメージは、免除リストのイメージと酷似しています。詳細については、「Content Moderation コンソール」をご参照ください。

レスポンスコード

API レスポンスコード。コード 200 を返すリクエストのみが課金されます。

コード	説明
200	リクエストは成功しました。
400	リクエストパラメーターが空です。
401	リクエストパラメーターが無効です。
402	リクエストパラメーターの長さが無効です。パラメーターを確認してリクエストを再試行してください。
403	リクエストレートが QPS 制限を超えています。同時実行数を確認して調整してください。
404	エラーまたはタイムアウトにより画像のダウンロードに失敗しました。画像 URL を確認して再試行してください。
405	画像のダウンロードがタイムアウトしました。画像にアクセスできない可能性があります。アクセス設定を確認して再試行してください。
406	入力画像が大きすぎます。画像サイズを小さくして再試行してください。
407	入力画像のフォーマットはサポートされていません。画像を変換して再試行してください。
408	この API を呼び出す権限が拒否されました。これは、サービスが有効化されていない、アカウントに支払い遅延がある、またはアカウントに権限がない場合に発生する可能性があります。
500	システムエラーが発生しました。

よくある質問

画像モデレーションのためにこの操作を呼び出す前に、ウェブページから画像を手動で抽出する必要がありますか？

いいえ。imageUrl パラメーターとして画像自体のパブリックにアクセス可能な URL を提供するだけで済みます。API は URL から画像コンテンツを自動的に取得してモデレーションするため、事前にウェブページから画像をダウンロードしたり抽出したりする必要はありません。画像が OSS バケットなどのプライベートバケットに保存されている場合は、操作を呼び出す前に Content Moderation がそのバケットにアクセスする権限を持っていることを確認してください。

Content Moderation をテストするための非準拠のサンプル画像はどこで入手できますか？

Alibaba Cloud は公式のテスト画像を提供していません。ビジネスシナリオに合ったテストサンプルを準備するか、公開されている準拠の画像リソースを使用して統合を検証してください。

GifParser timeout エラーを解決するにはどうすればよいですか？

GifParser timeout エラーは通常、画像のダウンロードに失敗したことを示します。まず、HTTP 画像 URL を HTTPS URL に置き換えて再度テストしてください。エラーが続く場合は、画像 URL がパブリックネットワークアクセスをサポートしていること、ファイルが標準 GIF であること、ファイルサイズがドキュメントに記載されている制限内であることを確認してください。また、画像へのネットワークパスが正常に機能していることも確認してください。

画像モデレーション 2.0 API を呼び出す際の InvalidAction.NotFound エラーコードを解決するにはどうすればよいですか？

以下の項目を確認してください：

x-acs-action リクエストヘッダーを、レガシーの ImageSyncScan 値ではなく ImageModeration に設定します。
リクエストの URI (リクエストパス) として、/api/v2/image/scan や /v2/image/scan ではなく /green-cip/v2/image/scan を使用します。
/green-cip プレフィックスを含む正確なリクエストパスで署名を計算します。
POST を使用してリクエストを送信し、画像モデレーション 2.0 サービスが有効化されていることを確認します。

可能な場合は、公式の Alibaba Cloud ソフトウェア開発キット (SDK) を使用してください。SDK はエンドポイント、リクエストパス、署名を処理し、手動でのリクエスト構築によるエラーを回避するのに役立ちます。