/green/video/syncscan - Content Moderation - Alibaba Cloud ドキュメントセンター

リアルタイムで動画をモデレートし、モデレーション結果を取得します。この操作を呼び出して、動画に危険なコンテンツや違法なコンテンツが含まれていないかどうかをモデレートできます。この操作は、ポルノ検出、テロコンテンツ検出、広告違反検出、不適切なシーン検出、ロゴ検出などのシナリオに適用できます。

説明

操作: /green/video/syncscan

この操作を呼び出して、動画モデレーションタスクを送信し、リアルタイムでモデレーション結果を取得できます。 HTTPリクエストを構成する方法の詳細については、リクエスト構造をご参照ください。既存のHTTPリクエストを選択することもできます。詳細については、SDKの概要をご参照ください。

課金方法:
この操作の呼び出しには料金が発生します。課金方法の詳細については、をご参照ください。
一度に複数のシナリオをモデレートするように指定した場合、すべてのシナリオの累積料金が請求されます。各シナリオの料金は、シナリオでモデレートされたビデオフレーム数にシナリオの単価を掛けた値です。
モデレート対象:
/green/video/syncscan操作を呼び出すには、モデレートする動画からキャプチャした一連のフレームを送信する必要があります。モデレートする動画を指定するために動画 URL を送信する場合は、/green/video/asyncscan 操作を呼び出すことをお勧めします。
動画からキャプチャされたフレームの制限:
- ビデオフレームの URL は、HTTP または HTTPS URL である必要があります。
- ビデオフレームは、PNG、JPG、JPEG、BMP、GIF、または WEBP 形式である必要があります。
- ビデオフレームのサイズは最大 10 MB です。
- モデレーション効果を確保するために、少なくとも 256 × 256 ピクセルのビデオフレームを送信することをお勧めします。
- 動画をモデレートする操作の応答時間は、動画からキャプチャされたフレームのダウンロード時間によって異なります。モデレートするビデオフレームを保存するために、安定した信頼性の高いストレージサービスを使用してください。オブジェクトストレージサービス（OSS）またはコンテンツデリバリーネットワーク（CDN）を使用することをお勧めします。

表 1. シナリオ
シナリオ	説明	モデレーション結果のカテゴリ
ポルノ検出	動画内のポルノコンテンツを検出します。	normal と porn
テロコンテンツ検出	動画内のテロコンテンツを検出します。	normal と terrorism
不適切なシーン検出	動画内の不適切なシーンを検出します。	normal と live
ロゴ検出	動画内の特定のロゴを検出します。	normal と logo
広告違反検出	動画内の広告またはテキスト違反を検出します。	normal と ad
音声アンチスパム説明このシナリオでは、/green/video/asyncscan 操作を呼び出して、非同期動画モデレーションタスクを送信する必要があります。詳細については、/green/video/asyncscan および /green/video/resultsをご参照ください。	動画内の音声アンチスパムを検出します。説明デフォルトでは、モデレートされる音声は中国語である必要があります。英語の音声をモデレートする必要がある場合は、営業担当者にお問い合わせください。	normal、spam、ad、politics、terrorism、abuse、porn、flood、contraband、および customized

QPS 制限

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

リクエストパラメータ

パラメータ	タイプ	必須	例	説明
bizType	String	いいえ	default	ビジネスシナリオ。でビジネスシナリオを作成できます。 Content Moderation console。詳細については、「機械支援モデレーションのポリシーのカスタマイズ」をご参照ください。
scenes	StringArray	はい	["porn"]	動画モデレーションシナリオ。有効な値: porn: ポルノ検出 terrorism: テロコンテンツ検出 live: 不適切なシーン検出 logo: ロゴ検出 ad: 広告違反検出
tasks	JSONArray	はい		送信するモデレーションタスクのリスト。JSON 配列には、1 つ以上の要素を含めることができます。各要素は構造体です。JSON 配列には最大 100 個の要素を含めることができます。つまり、一度に最大 100 個のタスクを送信できます。一度に 100 個のタスクを送信するには、関連する同時実行制限を 100 より大きい数に上げる必要があります。各要素の構造の詳細については、task をご参照ください。

表 2. task
パラメータ	タイプ	必須	例	説明
clientInfo	JSONObject	いいえ	{"userId":"12023****","userNick":"Mike","userType":"others"}	クライアントに関する情報。詳細については、共通パラメータの「共通リクエストパラメータ」セクションをご参照ください。サーバーは、グローバル clientInfo パラメータを使用するか、この表で説明されている clientInfo パラメータを使用するかを決定します。説明この表の clientInfo パラメーターは、グローバルパラメーターよりも優先されます。
dataId	String	いいえ	videoId****	モデレート対象の ID。 ID には、文字、数字、アンダースコア（_）、ハイフン（-）、およびピリオド（.）を含めることができます。長さは最大 128 文字です。この ID は、ビジネスデータを一意に識別します。
frames	JSONArray	はい		モデレートする動画からキャプチャされたフレームに関する情報。frames パラメータの JSON 配列の各要素は構造体です。各要素の構造の詳細については、frame をご参照ください。モデレートする動画ごとに最大 200 フレームをキャプチャできます。
framePrefix	String	いいえ		キャプチャされたフレームの URL のプレフィックス。これは、`frame.url` と共に使用されて、フレームの完全な URL を形成します。キャプチャされたフレームの完全な URL は、`framePrefix + frame.url` の形式です。詳細については、frame をご参照ください。

表 3. frame
パラメータ	タイプ	必須	例	説明
url	String	はい	http://www.aliyundoc.com/test0001.jpg	インターネット経由でアクセスできる HTTP または HTTPS の URL。URL の長さは最大 2,048 文字です。
オフセット	整数	いいえ	10	ビデオの開始とキャプチャされたフレームの間隔です。単位：秒。

レスポンスパラメータ

パラメータ	タイプ	例	説明
code	Integer	200	返された HTTP ステータスコード。詳細については、「一般的なエラーコード」をご参照ください。
msg	String	OK	リクエストに応じて返されるメッセージ。
dataId	String	videoId****	モデレーションオブジェクトの ID。説明モデレーションリクエストで dataId パラメータを設定した場合、dataId リクエストパラメータの値がここに返されます。
taskId	String	taskId****	モデレーションタスクの ID。
results	JSONArray		モデレーション結果。呼び出しが成功すると、HTTP ステータスコード 200 とモデレーション結果が返されます。モデレーション結果の配列には、1 つ以上の要素が含まれています。各要素は構造体です。構造体の詳細については、「result」をご参照ください。

表 4. result
パラメータ	タイプ	例	説明
scene	String	porn	モデレーションリクエストで指定した動画モデレーションシナリオ。有効な値： porn: ポルノグラフィ検出 terrorism: テロコンテンツ検出 live: 不適切なシーン検出 logo: ロゴ検出 ad: 広告違反検出
label	String	porn	動画モデレーション結果のカテゴリ。有効な値： scenes パラメータが porn に設定されている場合、有効な値は次のとおりです。 normal: 正常 porn: ポルノコンテンツ scenes パラメータが terrorism に設定されている場合、有効な値は次のとおりです。 normal: 正常 terrorism: テロコンテンツ scenes パラメータが live に設定されている場合、有効な値は次のとおりです。 normal: 正常 live: 不適切なシーン scenes パラメータが logo に設定されている場合、有効な値は次のとおりです。 normal: 正常 logo: ロゴ scenes パラメータが ad に設定されている場合、有効な値は次のとおりです。 normal: 正常 ad: 広告またはテキスト違反
sublabel	String	porn	scenes パラメータが porn または terrorism に設定されている場合、モデレーション結果のサブカテゴリがこのパラメータで返される場合があります。このパラメータはデフォルトでは返されません。
suggestion	String	block	推奨される後続操作。有効な値： pass: モデレーション対象のオブジェクトは、それ以上の操作を必要としません。 review: モデレーション対象のオブジェクトには、違反の疑いがあるコンテンツが含まれており、手動でのレビューが必要です。 block: モデレーション対象のオブジェクトには、違反が含まれています。オブジェクトを削除またはブロックすることをお勧めします。
rate	Float	99.2	信頼レベルのスコア。有効な値： 0 から 100 。値が大きいほど、信頼レベルが高いことを示します。 suggestion パラメータに pass の値が返された場合、信頼レベルが高いほど、コンテンツが正常である可能性が高くなります。提案レビューブロックsuggestion パラメータにまたはの値が返された場合、信頼レベルが高いほど、コンテンツに違反が含まれている可能性が高くなります。重要 suggestion、label、および sublabel パラメータに返される値を使用して、コンテンツに違反が含まれているかどうかを判断することをお勧めします。 sublabel パラメータは、特定の操作によって返されます。
frames	JSONArray		違反が含まれているキャプチャフレームに関する情報。構造体の詳細については、「frame」をご参照ください。
extras	JSONObject		追加情報。 scenes パラメータで ad を指定して広告違反を検出する場合、extras パラメータは次のコンテンツを返すことができます。 hitLibInfo: モデレーション対象の動画で検出されたテキストにヒットしたカスタムテキストライブラリに関する情報。構造体の詳細については、「hitLibInfo」をご参照ください。
hintWordsInfo	JSONArray		モデレーション対象の動画で検出された広告または不正なテキストにヒットした用語に関する情報。構造体の詳細については、「hintWordsInfo」をご参照ください。説明このパラメータは、広告違反検出にのみ適用されます。
logoData	JSONArray		モデレーション対象の動画で検出されたロゴに関する情報。構造体の詳細については、「logoData」をご参照ください。説明このパラメータは、ロゴ検出にのみ適用されます。
sfaceData	JSONArray		モデレーション対象の動画で検出されたテロコンテンツに関する情報。構造体の詳細については、「sfaceData」をご参照ください。説明このパラメータは、テロコンテンツ検出にのみ適用されます。

表 5. frame
パラメータ	タイプ	例	説明
url	String	http://www.aliyundoc.com/0B860000586C0A0300038A0460003	The HTTP or HTTPS URL that can be accessed over the Internet. The URL is up to 2,048 characters in length.
offset	Integer	50	動画の開始からキャプチャフレームまでの間隔。単位：秒。
label	String	porn	キャプチャフレームのモデレーション結果のカテゴリ。
rate	Float	99.1	信頼レベルのスコア。有効な値： 0 から 100 。信頼レベルが高いほど、モデレーション結果の信頼性が高くなります。このスコアをビジネスで使用しないことをお勧めします。

表 6. logoData
パラメータ	タイプ	例	説明
type	String	TV	検出されたロゴのタイプ。たとえば、TV の値は、禁止されているメディアのロゴを示します。
name	String	xxx TV	検出されたロゴの名前。
x	Float	140	ロゴ領域の左上隅と y 軸の間の距離。画像の左上隅が座標原点です。単位：ピクセル。
y	Float	68	ロゴ領域の左上隅と x 軸の間の距離。画像の左上隅が座標原点です。単位：ピクセル。
w	Float	106	ロゴ領域の幅。単位：ピクセル。
h	Float	106	ロゴ領域の高さ。単位：ピクセル。

表 7. sfaceData
パラメータ	タイプ	例	説明
x	Float	49	顔領域の左上隅と y 軸の間の距離。画像の左上隅が座標原点です。単位：ピクセル。
y	Float	39	顔領域の左上隅と x 軸の間の距離。画像の左上隅が座標原点です。単位：ピクセル。
w	Float	97	顔領域の幅。単位：ピクセル。
h	Float	131	顔領域の高さ。単位：ピクセル。
faces	JSONArray	[{"name":"Hit name","rate":91.54,"id":"AliFace_0123****"}]	認識された顔に関する情報。配列の各要素には、次のパラメータが含まれています。 name: 認識された顔の人の名前。値は文字列です。 rate: 信頼レベルのスコア。有効な値： 0 から 100 。値が大きいほど、信頼レベルが高いことを示します。信頼レベルが高いほど、顔認識結果の信頼性が高くなります。値は浮動小数点数です。 id: 認識された顔の ID。値は文字列です。

表 8. hitLibInfo
パラメータ	タイプ	例	説明
context	String	Haokan	検出されたテキストにヒットしたカスタム用語。
libCode	String	123456	検出されたテキストにヒットしたカスタム用語を含むライブラリのコード。
libName	String	abc	検出されたテキストにヒットしたカスタム用語を含むライブラリの名前。

表 9. hintWordsInfo
パラメータ	タイプ	例	説明
context	String	Haokan	検出されたテキストにヒットした用語。

例

リクエストの例

http(s)://[エンドポイント]/green/video/syncscan
&<共通リクエストパラメータ>
{
    "scenes": [
        "porn"  // porn
    ],
    "tasks": [
        {
            "dataId": "videoId****",
            "frames": [
                {
                    "offset": 10,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460000"
                },
                {
                    "offset": 20,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460001"
                },
                {
                    "offset": 30,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460002"
                },
                {
                    "offset": 40,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460003"
                },
                {
                    "offset": 50,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460003"
                },
                {
                    "offset": 60,
                    "url": "http://www.aliyundoc.com/0B860000586C0A0300038A046000x"
                }
            ]
        }
    ]
}

成功レスポンスの例

{
    "code": 200,
    "msg": "OK",
    "requestId": "requestID****",
    "data": [
        {
            "code": 200,
            "msg": "OK",
            "dataId": "videoId****",
            "taskId": "taskId****",
            "results": [
                {
                    "label": "porn",  // porn
                    "rate": 99.2,
                    "scene": "porn",  // porn
                    "suggestion": "block",  // block
                    "frames": [
                        {
                            "offset": 50,
                            "url": "http://www.aliyundoc.comm/0B860000586C0A0300038A0460003",
                            "label": "porn",  // porn
                            "rate": 99.1
                        }
                    ]
                }
            ]
        }
    ]
}