Content Moderation:ライブビデオストリームモデレーション API v2.0

オンボーディングガイド

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

2. Content Moderation の従量課金を有効にします。サービスを有効にしていることを確認してください。詳細については、「サービスの有効化」をご参照ください。サービスの有効化には料金はかかりません。API を使用すると、システムは使用量に基づいて自動的に請求します。詳細については、「課金の説明」をご参照ください。

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

4. サービスを開発して統合します。ソフトウェア開発キット (SDK) を使用して操作を呼び出すことをお勧めします。詳細については、「ビデオモデレーション SDK v2.0 と統合ガイド」をご参照ください。

5. ライブビデオストリームモデレーションサービスには、次の 3 つの API 操作が含まれます:

   • VideoModeration: ライブストリームモデレーションジョブの送信

   • VideoModerationResult: ライブストリームモデレーションジョブの結果のクエリ

   • VideoModerationCancel: ライブストリームモデレーションジョブのキャンセル

モデレーションジョブの送信

API の説明

• API 操作: VideoModeration。この操作は、ライブビデオストリームの非同期モデレーションのみをサポートします。

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

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

• 課金:

  これは有料操作です。ライブビデオフレームとオーディオに設定したモデレーションポリシーに基づいて課金されます。ライブビデオフレームでは、複数のサービスを選択できます。合計料金は、ビデオスナップショットの数に各サービスの単価を乗じて計算されます。ライブストリームのオーディオも違反についてモデレーションする場合、追加料金が課金されます。この料金は、ビデオの長さにオーディオモデレーション機能の単価を乗じて計算されます。課金方法の詳細については、「課金」をご参照ください。

• 検出オブジェクト: ライブビデオストリーム。

• 応答: 非同期モデレーションジョブはリアルタイムで結果を返しません。コールバックまたはポーリングを使用してモデレーション結果を取得する必要があります。

  • コールバックを使用してモデレーション結果を取得する: 非同期モデレーションジョブを送信するときに、リクエストで callback パラメーターを指定して、モデレーション結果を自動的に受信できます。

  • ポーリングを使用してモデレーション結果を取得する: 非同期モデレーションジョブを送信するときに、callback パラメーターを指定しないでください。ジョブを送信した後、結果クエリ操作を呼び出してモデレーション結果を取得できます。

• ライブストリームの要件:

  • サポートされているプロトコル: RTMP、HLS、HTTP-FLV、および RTSP。

  • ライブストリームの期間制限: 1 つのビデオストリームモデレーションジョブは最大 24 時間まで継続できます。この制限を超えるとジョブは自動的に終了します。

• 検出ルールの構成:

  • 最初の呼び出しでは、Content Moderation コンソールでライブストリームモデレーションルールを設定できます。

  • ルールを設定しない場合、ライブストリームモデレーション V2.0 API は次のデフォルト構成を使用します:

    サービス	デフォルト構成
    ライブストリーム検出 (liveStreamDetection_global)	固定フレームキャプチャ頻度: 1 フレーム/秒 ビデオフレーム検出サービス: 一般ベースライン検出 (baselineCheck_global) ビデオ音声検出: 有効 ビデオ音声検出サービス: ソーシャルおよびエンターテインメントライブストリーム検出 (live_stream_detection_global) 結果返却方法: 検出された脅威のある結果のみを返す
    ライブストリーム検出 (大規模モデル) (liveStreamDetectionByVL_global) 説明 現在、北京および上海リージョンでのみサポートされています。大規模モデルバージョンは、10 の同時取り込みエンドポイントに制限されています。	固定フレームキャプチャ頻度: 1 フレーム/秒 ビデオフレーム検出サービス: 大規模および小規模モデルによる画像モデレーションサービス (postImageCheckByVL) ビデオ音声検出: 有効 ビデオ音声検出サービス: 中国以外のリージョン向けのソーシャルおよびエンターテインメントライブストリーム検出 (live_stream_detection_cb) 結果返却方法: 検出された脅威のある結果のみを返す

QPS 制限

この操作のクエリ/秒 (QPS) 制限は、ユーザーごとに 100 です。同時モデレーションストリームの数は 50 に制限されています。これは、最大 50 のジョブを同時に処理できることを意味します。制限を増やすには、ビジネス担当者にお問い合わせください。制限を超えると、API 呼び出しがスロットルされます。これはビジネスに影響を与える可能性があります。操作は適切な方法で呼び出してください。

デバッグ

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

リクエストパラメーター

表 1. ServiceParameters

応答パラメーター

例

リクエストの例

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

成功応答の例

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

ライブストリームモデレーションジョブの結果のクエリ

API の説明

• API 操作: VideoModerationResult。

• 課金: この操作は課金されません。

• クエリタイムアウト: クエリ間隔を 30 秒に設定できます。これは、非同期モデレーションジョブを送信してから 30 秒後に結果をクエリできることを意味します。最大クエリ期間は 24 時間です。24 時間後、結果は自動的に削除されます。

• 結果の返却: ライブストリームが進行中の場合、クエリごとに最後の 10 件のモデレーション結果が返されます。ライブストリームが終了した場合、すべてのモデレーション結果が返されます。

QPS 制限

この操作の QPS 制限は、ユーザーごとに 100 です。制限を超えると、API 呼び出しがスロットルされます。これはビジネスに影響を与える可能性があります。操作は適切な方法で呼び出してください。

デバッグ

統合前に、Alibaba Cloud OpenAPI を使用して VideoModerationResult API をオンラインでデバッグすることもできます。これにより、サンプルコードと SDK 依存関係情報を表示し、API のメソッドとパラメーターの概要を取得できます。

リクエストパラメーター

表 1. ServiceParameters

応答パラメーター

表 2. Data

表 3. FrameResult

表 4. FrameSummarys

表 5. Frames

表 6. Results

表 7. Result

表 8. audioResult

表 9. AudioSummarys

表 10. SliceDetails

例

リクエストの例

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

成功応答の例

• ライブストリームビデオのみのモデレーション

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "success finished",
    "Data": {
        "DataId": "dc16c28f-xxxx-xxxx-xxxx-51efe0131080",
        "LiveId": "live0307-0728-****",
        "RiskLevel": "high",
        "FrameResult": {
            "FrameNum": 2,
            "FrameSummarys": [
                {
                    "Label": "violent_explosion",
                    "Description": "Suspected to contain fireworks",
                    "LabelSum": 8
                },
                {
                    "Label": "sexual_cleavage",
                    "Description": "Suspected to contain nudity or sexual content",
                    "LabelSum": 8
                }
            ],
            "RiskLevel": "medium",
            "Frames": [
                {
                    "Offset": 1,
                    "RiskLevel": "none",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "No risk detected"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test1.jpg",
                    "Timestamp": 1704769999000
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 78.88,
                                    "Label": "sexual_cleavage",
                                    "Description": "Suspected to contain nudity or sexual content"
                                },
                              	{
                                    "Confidence": 74.18,
                                    "Label": "violent_explosion",
                                    "Description": "Suspected to contain fireworks"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test2.jpg",
                    "Timestamp": 1704769989000
                }
            ]
        }
    }
}

• ライブストリームビデオとオーディオの両方のモデレーション

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "success finished",
    "Data": {
        "DataId": "dc16c28f-xxxx-xxxx-xxxx-51efe0131080",
        "LiveId": "live0307-0728-****",
        "RiskLevel": "high",
        "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": "Suspected to contain fireworks",
                    "LabelSum": 8
                },
                {
                    "Label": "sexual_cleavage",
                    "Description": "Suspected to contain nudity or sexual content",
                    "LabelSum": 8
                }
            ],
            "RiskLevel": "medium",
            "Frames": [
                {
                    "Offset": 1,
                    "RiskLevel": "none",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "No risk detected"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test1.jpg",
                    "Timestamp": 1704769999000
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 74.18,
                                    "Label": "violent_explosion",
                                    "Description": "Suspected to contain fireworks"
                                },
                                {
                                    "Confidence": 78.88,
                                    "Label": "sexual_cleavage",
                                    "Description": "Suspected to contain nudity or sexual content"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test2.jpg",
                    "Timestamp": 1704769989000
                }
            ]
        }
    }
}

ライブストリームモデレーションジョブのキャンセル

API の説明

この操作を呼び出して、ライブストリームモデレーションジョブをキャンセルできます。

• API 操作: VideoModerationCancel。

• 課金: この操作は課金されません。

デバッグ

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

リクエストパラメーター

表 11. ServiceParameters

応答パラメーター

例

リクエストの例

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

応答の例

{
    "Msg": "OK",
    "Code": 200,
    "RequestId": "70ED13B0-BC22-576D-9CCF-1CC12FEAC477"
}

コードの説明

このトピックでは、ApsaraVideo ライブストリーム監査 バージョン 2.0 API の応答コードについて説明します。応答コードが 200 または 280 のリクエストに対してのみ課金されます。他の応答コードを返すリクエストは課金されません。