/green/image/asyncscan および /green/image/results - Content Moderation

画像を非同期でモデレートし、モデレーション結果を照会します。 /green/image/asyncscan オペレーションを呼び出して、画像に危険なコンテンツや違法なコンテンツがないかモデレートし、/green/image/results オペレーションを呼び出して、モデレーション結果を照会できます。これらのオペレーションは、ポルノ検出、テロコンテンツ検出、広告違反検出、QRコード検出、好ましくないシーン検出、ロゴ検出などのシナリオに適用できます。

/green/image/asyncscan オペレーションの説明

オペレーション: /green/image/asyncscan

このオペレーションを呼び出して、非同期画像モデレーションタスクを送信できます。 HTTPリクエストを構成する方法の詳細については、「リクエスト構造」をご参照ください。既存のHTTPリクエストを選択することもできます。詳細については、「SDKの概要」をご参照ください。

課金方法:
このオペレーションの呼び出しには料金が発生します。課金方法の詳細については、「」を参照してください。
レスポンスタイムアウト:
同期モデレーションリクエストで許可される最大応答時間は 6 秒です。 6 秒以内にモデレーションが完了しない場合は、タイムアウトエラーが返されます。リアルタイムでモデレーション結果が必要ない場合は、非同期モデレーションリクエストを送信できます。ほとんどの場合、同期モデレーションオペレーションの方が呼び出しやすいため、同期モデレーションリクエストを送信することをお勧めします。同期モデレーションオペレーションを呼び出す場合は、タイムアウト期間を 6 秒に設定することをお勧めします。
返される結果:
非同期モデレーションリクエストを送信した場合、モデレーション結果はリアルタイムで返されません。モデレーション結果を取得するには、モデレーション結果を定期的にポーリングするか、コールバック通知を有効にします。モデレーション結果は最大 1 時間保持されます。
- コールバック通知を有効にしてモデレーション結果を取得する: 非同期モデレーションタスクを送信するときに、モデレーションリクエストの callback パラメーターでモデレーション結果を受信するためのコールバック URL を指定できます。 callback パラメーターの詳細については、「リクエストパラメーター」をご参照ください。
- 定期的にモデレーション結果をポーリングする: 非同期モデレーションタスクを送信するときに、callback パラメーターを設定する必要はありません。タスクを送信した後、/green/image/results オペレーションを呼び出して、モデレーション結果を照会できます。このオペレーションの詳細については、「 /green/image/results オペレーションの説明」をご参照ください。
画像の制限:
- 画像の URL は、HTTP または HTTPS URL である必要があります。
- 画像は、PNG、JPG、JPEG、BMP、GIF、または WEBP 形式である必要があります。
- 画像のサイズは最大 20 MB です。画像サイズの制限は、同期モデレーションオペレーションと非同期モデレーションオペレーションの両方に適用されます。
- 画像のダウンロード時間は 3 秒に制限されています。 3 秒以内に画像をダウンロードできない場合は、タイムアウトエラーが返されます。
- モデレーション効果を確保するために、少なくとも 256 × 256 ピクセルの画像を送信することをお勧めします。
- 画像をモデレートするオペレーションの応答時間は、これらの画像のダウンロード時間によって異なります。モデレートする画像を保存するために、安定していて信頼できるストレージサービスを使用してください。オブジェクトストレージサービス (OSS) またはコンテンツデリバリーネットワーク (CDN) を使用することをお勧めします。

表 1. シナリオ
シナリオ	説明	モデレーション結果のカテゴリ
ポルノ検出	画像内のポルノまたはセクシーなコンテンツを検出します。	normal、porn、sexy
テロコンテンツ検出	画像内のテロまたは政治的コンテンツを検出します。	normal、bloody、explosion、outfit、logo、weapon、politics、violence、crowd、parade、carcrash、flag、location
広告違反検出	画像内の広告または違反テキストを検出します。	normal、politics、porn、abuse、terrorism、contraband、spam、npx、qrcode、programCode、ad 説明機械支援モデレーションのカスタムポリシーを作成し、実際の要件に基づいて検出するカテゴリを指定できます。詳細については、「機械支援モデレーションのポリシーをカスタマイズする」をご参照ください。
QR コード検出	画像内の QR コードまたはミニプログラムコードを検出します。	normal、qrcode、programCode 説明機械支援モデレーションのカスタムポリシーを作成し、実際の要件に基づいて検出するカテゴリを指定できます。詳細については、「機械支援モデレーションのポリシーをカスタマイズする」をご参照ください。
好ましくないシーン検出	画像内の好ましくないシーン (黒い画面、黒い縁、暗い画像、ピクチャインピクチャ (PiP)、喫煙、運転中のライブストリーミングなど) を検出します。	normal、meaningless、PIP、smoking、drivelive
ロゴ検出	画像内のロゴ (テレビ局のロゴや商標など) を検出します。	normal、TV、trademark

QPS 制限

このオペレーションは、アカウントごとに 1 秒あたり最大 50 回呼び出すことができます。 1 秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。その結果、ビジネスに影響が及ぶ可能性があります。このオペレーションを呼び出すときは、制限に注意することをお勧めします。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
bizType	String	いいえ	default	ビジネスシナリオ。ビジネスシナリオを作成できます。 Content Moderation console。詳細については、「機械支援モデレーションのポリシーのカスタマイズ」をご参照ください。
scenes	StringArray	はい	["porn"]	モデレーションシナリオ。有効な値: porn: ポルノ検出 terrorism: テロコンテンツ検出 ad: 広告違反検出 qrcode: QR コード検出 live: 好ましくないシーン検出 logo: ロゴ検出複数のシナリオを指定できます。たとえば、`["porn","terrorism"]` の形式で porn と terrorism の両方を指定して、ポルノコンテンツとテロコンテンツを検出できます。説明一度に複数のシナリオをモデレーションに指定した場合、すべてのシナリオの累積料金が請求されます。各シナリオの料金は、そのシナリオでモデレートされた画像の数にそのシナリオの単価を掛けたものに等しくなります。
callback	String	いいえ	http://www.aliyundoc.com	非同期モデレーション結果を通知するためのコールバック URL。 HTTP および HTTPS URL がサポートされています。このパラメーターを設定しない場合は、モデレーション結果を定期的にポーリングする必要があります。モデレーションリクエストで callback パラメーターを設定する場合は、指定した HTTP または HTTPS URL が次の要件を満たしていることを確認してください。POST メソッドをサポートしていること、送信データのエンコードに UTF-8 を使用していること、checksum パラメーターと content パラメーターをサポートしていること。モデレーション結果を指定されたコールバック URL に送信するために、コンテンツモデレーションは次のルールと形式に基づいてコールバック通知で checksum パラメーターと content パラメーターを返します。 checksum: セキュアハッシュアルゴリズム 256 (SHA-256) アルゴリズムによって生成される、UID + Seed + Content 形式の文字列。 UID は、Alibaba Cloud アカウントの ID を示します。 ID は、Alibaba Cloud 管理コンソールで照会できます。データの改ざんを防ぐために、サーバーがコールバック通知を受信したときに SHA-256 アルゴリズムを使用して文字列を生成し、受信した checksum パラメーターと照合して検証できます。説明 UID は、Alibaba Cloud アカウントの ID である必要があり、RAM ユーザーの ID ではありません。 content: JSON 形式の文字列で、コールバックデータを JSON 形式に解析します。 content パラメーターの形式の詳細については、非同期モデレーション結果を照会するために呼び出すことができる各オペレーションの成功レスポンスの例をご参照ください。説明サーバーがコールバック通知を正常に受信した場合、サーバーは HTTP 200 ステータスコードをコンテンツモデレーションに送信します。サーバーがコールバック通知を受信できなかった場合、サーバーは他の HTTP ステータスコードをコンテンツモデレーションに送信します。サーバーがコールバック通知を受信できなかった場合、コンテンツモデレーションは、サーバーがコールバック通知を受信するまで、コールバック通知のプッシュを続けます。コンテンツモデレーションは、コールバック通知を最大 16 回繰り返しプッシュできます。 16 回後、コンテンツモデレーションはコールバック通知のプッシュを停止します。この場合、コールバック URL のステータスを確認することをお勧めします。
seed	String	いいえ	abc_123	コールバック通知リクエストの署名を生成するために使用されるランダムな文字列。文字列の長さは最大 64 文字で、文字、数字、アンダースコア (_) を含めることができます。この文字列はカスタマイズできます。コンテンツモデレーションがサーバーにコールバック通知をプッシュするときに、コールバック通知リクエストを検証するために使用されます。説明 callback パラメーターを設定する場合は、このパラメーターが必要です。
cryptType	String	いいえ	SHA256	コールバック通知を有効にしたときに、コールバック通知コンテンツの暗号化に使用される暗号化アルゴリズム。コンテンツモデレーションは、指定した暗号化アルゴリズムを使用して返された文字列を暗号化し、暗号化された文字列をコールバック URL に送信します。返される文字列は、`UID + Seed + Content` 形式です。有効な値: SHA256: HMAC-SHA256 暗号化アルゴリズムが使用されます。これはデフォルト値です。 SM3: HMAC-SM3 暗号化アルゴリズムが使用され、16 進数の文字列が返されます。文字列は小文字と数字で構成されます。たとえば、HMAC-SM3 暗号化アルゴリズムを使用して abc を暗号化すると、66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0 が返されます。
offline	Boolean	いいえ	false	ニアラインモデレーションモードまたはリアルタイムモデレーションモードを有効にするかどうかを指定します。有効な値: true: ニアラインモデレーションモードを有効にします。このモードでは、送信したモデレーションタスクはリアルタイムで処理されない場合がありますが、処理のためにキューに入れられ、24 時間以内に開始されます。 false: リアルタイムモデレーションモードを有効にします。これはデフォルト値です。このモードでは、コンテンツモデレーションは同時実行制限を超えるモデレーションリクエストを拒否します。
tasks	JSONArray	はい		モデレートするオブジェクトのリスト。 JSON 配列には、1 つ以上の要素を含めることができます。各要素は構造体です。 JSON 配列には最大 100 個の要素を含めることができます。つまり、一度に最大 100 個のオブジェクトを送信できます。一度に 100 個のオブジェクトを送信するには、関連する同時実行制限を 100 より大きい数に上げる必要があります。各要素の構造の詳細については、「task」をご参照ください。

表 1. task
パラメーター	タイプ	必須	例	説明
clientInfo	JSONObject	いいえ	{"userId":"12023****","userNick":"Mike","userType":"others"}	クライアントに関する情報。詳細については、「共通パラメーター」の「共通リクエストパラメーター」セクションをご参照ください。サーバーは、グローバル clientInfo パラメーターを使用するか、この表で説明されている clientInfo パラメーターを使用するかを決定します。説明この表の clientInfo パラメーターは、グローバルパラメーターよりも優先されます。
dataId	String	いいえ	test4lNSMdggA0c56MMvfYoh4e-1mwxpx	モデレーションオブジェクトの ID。 ID には、文字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を含めることができます。長さは最大 128 文字です。この ID は、ビジネスデータを一意に識別します。
url	String	はい	https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png	インターネット経由でアクセスできる HTTP または HTTPS URL。 URL の長さは最大 2,048 文字です。
extras	JSONObject	いいえ		オペレーションを呼び出すために指定できる追加パラメーター。このパラメーターは、画像モデレーションには必須ではありません。
interval	Integer	いいえ	1	連続してキャプチャされる 2 つのフレームの間隔。このパラメーターは、GIF または長い画像のモデレーション専用です。 GIF 画像はフレームの配列と見なすことができます。 n は interval パラメーターで指定され、n フレームごとに 1 フレームがモデレーションのためにキャプチャされます。システムは、このパラメーターが指定されている場合にのみ、GIF 画像からフレームをキャプチャします。長い画像は、縦向きまたは横向きモードで表示できます。高さが 400 ピクセルを超え、高さの幅に対する比率が 2.5 を超える長い縦向きの画像をモデレートするには、高さを幅で割り、結果を最も近い整数に切り上げてフレームの総数とします。幅が 400 ピクセルを超え、幅の高さに対する比率が 2.5 を超える長い横向きの画像をモデレートするには、幅を高さで割り、結果を最も近い整数に切り上げてフレームの総数とします。デフォルトでは、GIF 画像または長い画像の最初のフレームのみがモデレートされます。 interval パラメーターを使用して、システムが連続してキャプチャする 2 つのフレームの間隔を指定できます。これにより、モデレーションコストを削減できます。説明 interval パラメーターと maxFrames パラメーターはペアで使用する必要があります。たとえば、GIF 画像または長い画像をモデレートするために、interval パラメーターを 2 に設定し、maxFrames パラメーターを 20 に設定します。この例では、2 フレームごとに 1 フレームがモデレートされ、最大 20 フレームをモデレートできます。料金は、モデレートされたフレームの実際の数に基づいて計算されます。
maxFrames	Integer	いいえ	20	キャプチャするフレームの最大数。このパラメーターは、GIF または長い画像のモデレーション専用です。デフォルト値: 1。 interval パラメーターの値に `maxFrames` パラメーターの値を掛けたものが、GIF 画像または長い画像のフレームの総数よりも小さい場合、フレームをキャプチャする間隔は、画像のフレームの総数を maxFrames パラメーターの値で割った結果から切り上げた整数に自動的に変更されます。これにより、全体的なモデレーション効果が向上します。

レスポンスパラメーター

パラメーター	タイプ	例	説明
code	Integer	200	返される HTTP ステータスコード。詳細については、「共通エラーコード」をご参照ください。
msg	String	OK	リクエストに応じて返されるメッセージ。
dataId	String	test4lNSMdggA0c56MMvfYoh4e-1mwxpx	モデレーションオブジェクトの ID。説明モデレーションリクエストで dataId パラメーターを設定した場合、dataId リクエストパラメーターの値がここに返されます。
taskId	String	fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695	モデレーションタスクの ID。
url	String	https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png	インターネット経由でアクセスできる HTTP または HTTPS URL。 URL の長さは最大 2,048 文字です。

例

リクエストの例

http(s)://[Endpoint]/green/image/asyncscan
&<共通リクエストパラメーター> // 共通リクエストパラメーター
{
    "scenes": [
        "porn"
    ],
    "tasks": [
        {
            "dataId": "test4lNSMdggA0c56MMvfYoh4e-1mwxpx",
            "url": "https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
        }
    ]
}

成功レスポンスの例

{
    "code": 200,
    "msg": "OK",
    "requestId": "95AD868A-F5D2-4AEA-96D4-E0273B8E074C",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "test4{
  "error": {
    "code": 500,
    "message": "Internal error encountered.",
    "status": "INTERNAL"
  }
}
lNSMdggA0c56MMvfYoh4e-1mwxpx",
            "taskId": "fdd25f95-4892-4d6b-aca9-7939bc6e9baa-1486198766695",
            "url": "https://www.aliyundoc.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
        }
    ]
}

/green/image/results オペレーションの説明

オペレーション: /green/image/results

このオペレーションを呼び出して、非同期画像モデレーション結果を照会できます。 HTTPリクエストを構成する方法の詳細については、「リクエスト構造」をご参照ください。既存のHTTPリクエストを選択することもできます。詳細については、「SDKの概要」をご参照ください。

課金方法:
このオペレーションは無料です。
レスポンスタイムアウト:
クエリ間隔を 30 秒に設定することをお勧めします。これにより、非同期画像モデレーションタスクを送信してから 30 秒後にモデレーション結果を照会し、taskId パラメーターの値を取得できます。
説明 offline パラメーターを true に設定した場合、taskId パラメーターの値の有効期間は 24 時間です。 offline パラメーターを false に設定した場合、taskId パラメーターの値の有効期間は 1 時間です。 offline パラメーターのデフォルト値は false です。