Content Moderation:動画ファイル審査 2.0 API

統合ガイド

1. Alibaba Cloud アカウントを登録し、指示に従って登録を完了してください: 今すぐ登録。

2. Content Moderation の従量課金方法を有効化してください。 詳細については、サービスを有効化するをご参照ください。 有効化は無料です。 API 操作を使用すると、使用量に基づいて自動的に課金されます。 詳細については、「課金」をご参照ください。

3. Resource Access Management (RAM) を使用して AccessKey を作成します。詳細については、AccessKey の作成をご参照ください。RAM ユーザーの AccessKey を使用する場合は、Alibaba Cloud アカウントを使用して、RAM ユーザーに AliyunYundunGreenWebFullAccess 権限を付与する必要があります。詳細については、RAM での権限付与をご参照ください。

4. サービスを開発し、統合します。SDK を使用して API 操作を呼び出すことを推奨します。詳細については、動画審査 2.0 SDK と統合ガイドをご参照ください。

5. 動画ファイル審査サービスには、次の 2 つの API 操作が含まれます：

   • VideoModeration：動画ファイル審査タスクを送信します。

   • VideoModerationResult：動画ファイル審査タスクの結果を取得します。

審査タスクの送信

API の説明

• API 操作：VideoModeration。この操作は、動画の非同期検出のみをサポートします。

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

  リージョン	パブリックエンドポイント	VPC エンドポイント	サポートされているサービス
  シンガポール	green-cip.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com	videoDetection_global, videoDetectionByVL_global
  米国 (バージニア)	https://green-cip.us-east-1.aliyuncs.com	https://green-cip-vpc.us-east-1.aliyuncs.com	videoDetection_global
  米国 (シリコンバレー)	https://green-cip.us-west-1.aliyuncs.com	利用不可
  ドイツ (フランクフルト)	green-cip.eu-central-1.aliyuncs.com	利用不可

• 課金情報：

  この API 操作は課金対象です。設定した動画フレームと音声検出ポリシーに基づいて課金されます。動画フレームについては、複数のサービスを選択できます。フレーム数に各サービスの単価を乗じた金額が課金されます。音声コンテンツの違反も検出する場合、動画の長さに音声違反機能の単価を乗じた追加料金が課金されます。課金方法の詳細については、課金をご参照ください。

• 検出対象：動画ファイル。

• 戻り値：非同期検出タスクは、検出結果をリアルタイムで返しません。コールバックまたはポーリングを使用して検出結果を取得する必要があります。検出結果は最大 24 時間保持されます。

  • コールバックを使用して検出結果を取得する：非同期検出タスクを送信する際に、リクエストに callback パラメーターを含めることで、検出結果を自動的に受信します。

  • ポーリングを使用して検出結果を取得する：非同期検出タスクを送信する際に、callback パラメーターを含める必要はありません。タスクを送信した後、結果クエリ API 操作を呼び出して検出結果を取得します。

• 動画の要件：

  • 動画ファイルの URL は HTTP および HTTPS プロトコルをサポートします。

  • サポートされている動画ファイル形式は、AVI、FLV、MP4、MPG、ASF、WMV、MOV、WMA、RMVB、RM、FLASH、TS、および M3U8 です。

  • 動画サイズの制限：デフォルトでは、1 つの動画は 500 MB を超えることはできません。動画が 500 MB を超える場合は、動画をセグメントに分割できます。また、アカウントマネージャーに連絡してサイズ制限を増やすこともできます。

  • 動画ファイルの検出に必要な時間は、動画のダウンロード時間によって異なります。動画ファイルが配置されているストレージサービスが安定していて信頼できることを確認してください。動画ファイルの保存には、Alibaba Cloud Object Storage Service (OSS) を使用することを推奨します。

• 検出ルールの構成：

  • この操作を初めて呼び出すときは、Content Moderation コンソールで動画審査ルールを設定する必要があります。

    説明

    コンソールでは、スナップショットメソッド、スナップショットの頻度、画像審査ルール、音声審査ルール、返す結果の範囲などの設定を構成できます。詳細については、コンソールユーザーガイドをご参照ください。

• 何も設定しない場合、ビデオ審査 2.0 API のデフォルト設定は次のとおりです：

  サービス	デフォルト設定
  ビデオファイル検出 (videoDetection_global)	ビデオスナップショットの周波数：1 フレーム/秒 ビデオフレーム検出サービス：汎用ベースライン検出 (baselineCheck_global) ビデオ音声検出：有効 ビデオ音声検出サービス：多言語音声・動画メディア検出 (audio_multilingual_global) 結果の返却方式：検出された脅威を含む結果のみを返却
  ビデオファイル検出 (中国本土以外) (videoDetectionByVL_global) 説明 現在、シンガポールリージョンでのみアクティブです。大規模モデルバージョンは、10 個の同時取り込みエンドポイントに制限されています。	ビデオスナップショットの周波数：1 フレーム/秒 ビデオフレーム検出サービス：大小モデル融合による画像審査サービス (postImageCheckByVL_global) ビデオ音声検出：有効 ビデオ音声検出サービス：多言語音声・動画メディア検出 (audio_multilingual_global) 結果の返却方式：検出された脅威を含む結果のみを返却

QPS 制限

この API 操作のクエリ/秒 (QPS) 制限は、単一ユーザーあたり 100 で、同時審査タスクの制限は 50 です。 (これは、同時に 50 個のタスクしか処理できないことを意味します。 同時タスクの制限を引き上げるには、アカウントマネージャーにお問い合わせください。) 制限を超過した場合、速度制限がトリガーされます。 これはお客様のビジネスに影響を与える可能性があります。 この操作を呼び出す際は、これらの制限に注意することをお勧めします。

デバッグ

統合前に、Alibaba Cloud OpenAPI を使用して、VideoModeration API をオンラインでデバッグし、サンプルコードと SDK の依存関係情報を表示して、API の使用方法とパラメーターを確認できます。

リクエストパラメーター

表 1 サービスパラメーター

レスポンスパラメーター

例

クエリ例

{
    "Service": "videoDetection_global",
    "ServiceParameters": {
        "url": "http://www.aliyundoc.com/a.flv",
        "dataId": "videoId****"
    }
}

成功応答のサンプル

{
    "Message": "OK",
    "Code": 200,
    "Data": {
        "TaskId": "AAAAA-BBBBB",
        "DataId": "videoId****"
    },
    "RequestId": "ABCD1234-1234-1234-1234-123****"
}

動画ファイルモデレーションタスクの結果を取得する

API の説明

• API 操作：VideoModerationResult。 この操作は、ビデオファイルモデレーションタスクの結果を取得します。

• 課金情報：この API 操作は課金されません。

• クエリのタイムアウト：推奨されるクエリ間隔は 30 秒です。非同期検出タスクを送信してから 30 秒後に結果をクエリしてください。結果は 24 時間後に自動的に削除されます。

QPS 制限

この操作の QPS 制限は、アカウントあたり毎秒 100 回の呼び出しです。毎秒の呼び出し回数がこの制限を超えると、速度制限がトリガーされます。これはお客様のビジネスに影響を及ぼす可能性があります。この操作を呼び出す際は、この制限に注意することをお勧めします。

デバッグ

統合前に、Alibaba Cloud OpenAPI を使用して、VideoModerationResult API をオンラインでデバッグし、サンプルコードと SDK の依存関係情報を表示し、API とそのパラメーターの使用方法を確認できます。

リクエストパラメーター

表 1 サービスパラメーター

レスポンスパラメーター

表 2. データ

表 3 FrameResult

表 4 FrameSummary

表 5 フレーム

表 6 結果

表 7 結果

表 8 audioResult

表 9 AudioSummarys

表 10 SliceDetails

例

クエリ例

{
    "Service": "videoDetection_global",
    "ServiceParameters": {
        "taskId": "abcd****"
    }
}

成功応答例

• ビデオフレームの検出のみ

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "success finished",
    "Data": {
        "DataId": "ABCDEF-TESTDATAID",
        "TaskId": "AAAAA-BBBBB-2024-0307-0728",
        "FrameResult": {
            "FrameNum": 2,
            "FrameSummarys": [
                {
                    "Label": "violent_explosion",
                    "LabelSum": 8
                },
                {
                    "Label": "sexual_cleavage",
                    "LabelSum": 5
                }
            ],
            "Frames": [
                {
                    "Offset": 1,
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test1.jpg"
                },
                {
                    "Offset": 2,
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 1,
                                    "Label": "sexual_cleavage"
                                },
                                {
                                    "Confidence": 74.1,
                                    "Label": "violent_explosion"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test2.jpg"
                }
            ]
        }
    }
}

• ビデオフレームと音声の両方を検出します

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "正常に終了しました",
    "Data": {
        "DataId": "ABCDEF-TESTDATAID",
        "TaskId": "AAAAA-BBBBB-2024-0307-0728",
        "RiskLevel": "medium",
        "AudioResult": {
            "AudioSummarys": [
                {
                    "Label": "sexual_sounds",
                    "LabelSum": 3
                }
            ],
            "RiskLevel": "high",
            "SliceDetails": [
                {
                    "EndTime": 60,
                    "EndTimestamp": 1698912813192,
                    "Labels": "",
                    "RiskLevel": "none",
                    "StartTime": 30,
                    "StartTimestamp": 1698912783192,
                    "Text": "Content Moderation",
                    "Url": "http://abc.oss-ap-southeast-1.aliyuncs.com/test.wav"
                },
                {
                    "EndTime": 30,
                    "EndTimestamp": 1698912813192,
                    "Extend": "{\"customizedWords\":\"service\",\"customizedLibs\":\"test\"}",
                    "Labels": "C_customized",
                    "RiskLevel": "high",
                    "StartTime": 0,
                    "StartTimestamp": 1698912783192,
                    "Text": "Welcome to Alibaba Cloud Content Moderation service",
                    "Url": "http://abc.oss-ap-southeast-1.aliyuncs.com/test.wav"
                }
            ]
        },
        "FrameResult": {
            "FrameNum": 2,
            "FrameSummarys": [
                {
                    "Label": "violent_explosion",
                    "Description": "花火のようなコンテンツ要素が含まれている疑いがあります",
                    "LabelSum": 8
                },
                {
                    "Label": "sexual_cleavage",
                    "Description": "肌の露出または性的な示唆を含むコンテンツが含まれている疑いがあります",
                    "LabelSum": 8
                }
            ],
            "RiskLevel": "medium",
            "Frames": [
                {
                    "Offset": 1,
                    "RiskLevel": "none",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "リスクは検出されませんでした"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test1.jpg"
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 1,
                                    "Label": "sexual_cleavage",
                                    "Description": "肌の露出または性的な示唆を含むコンテンツが含まれている疑いがあります"
                                },
                                {
                                    "Confidence": 74.1,
                                    "Label": "violent_explosion",
                                    "Description": "花火のようなコンテンツ要素が含まれている疑いがあります"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test2.jpg"
                }
            ]
        }
    }
}

コードの説明

次の表では、動画ファイル審査2.0 API によって返される Code の値の意味について説明します。Code の値として 200 または 280 を返すリクエストにのみ課金されます。その他の Code の値を返すリクエストは課金されません。