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

Alibaba Cloudコンテンツモデレーションによって返されたビデオモデレーション結果が期待どおりでない場合は、フィードバックを提供するためのオペレーションを呼び出すことができます。Alibaba Cloudコンテンツモデレーションは、お客様のフィードバックに基づいてアルゴリズムモデルを最適化します。

説明

オペレーション: /green/video/feedback

このオペレーションを呼び出して、ビデオモデレーションタスクの結果に関するフィードバックを提供し、期待される結果を提供できます。 HTTPリクエストを構成する方法の詳細については、リクエスト構造をご参照ください。既存のHTTPリクエストを選択することもできます。詳細については、SDKの概要をご参照ください。

課金：このオペレーションは無料です。

QPS制限

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

リクエストパラメータ

すべてのコンテンツモデレーションAPIリクエストに含める必要がある共通リクエストパラメータの詳細については、共通パラメータをご参照ください。

リクエストボディはJSON構造です。次の表に、リクエストボディに含まれるパラメータを示します。

パラメータ	タイプ	必須	例	説明
taskId	String	はい	taskId xxx	コンテンツモデレーションサーバーによって返されるID。モデレーションタスクを一意に識別します。
dataId	String	いいえ	dataId xxx	モデレーションリクエストの dataId パラメータに指定した、モデレーション対象のビデオのID。
url	String	いいえ	http://www.aliyundoc.com/d.mp4	モデレーションリクエストで指定した、モデレーション対象のビデオのURL。モデレーションリクエストでビデオURLを指定していない場合は、このパラメータを設定しないでください。
suggestion	String	いいえ	block	返されることを期待するモデレーション結果。有効な値： pass: モデレーション対象のビデオは正常です。 block: モデレーション対象のビデオに違反が含まれています。
scenes	StringArray	いいえ	["ad","terrorism"]	ビデオモデレーションのシナリオ。有効な値： porn: ポルノグラフィ検出 terrorism: テロコンテンツ検出 ad: 広告検出説明 `scenes` パラメータには、複数のモデレーションシナリオを指定できます。たとえば、ポルノグラフィ検出とテロコンテンツ検出の両方のシナリオを示すために、pornとterrorismの両方を指定できます。
frames	JSONArray	はい		検出されたカテゴリに該当すると考えるキャプチャフレームの情報。 frames パラメータのJSON配列の各要素は構造体です。各要素の構造の詳細については、frame をご参照ください。

表 1. frame

パラメータ	タイプ	必須	例	説明
url	String	はい	http://www.aliyundoc.com/1.jpg	キャプチャフレームのURL。
offset	Integer	はい	100	ビデオの開始からキャプチャフレームまでの間隔。単位：秒。
note	String	いいえ	blabla	備考。

レスポンスパラメータ

このオペレーションが返す共通レスポンスパラメータの詳細については、レスポンスをご参照ください。

レスポンスボディのdataパラメータは空です。

例

リクエストの例

http(s)://[Endpoint]/green/video/feedback
&<共通リクエストパラメータ>
{
  "taskId":"taskId xxx",
  "dataId":"dataId xxx",
  "url":"http://www.aliyundoc.com/d.mp4",
  "frames":[
    {
      "url":"http://www.aliyundoc.com/1.jpg",
      "offset":100
    },
    {
      "url":"http://www.aliyundoc.com/2.jpg",
      "offset":200
    }
  ],
  "suggestion": "block",
  "scenes":[
    "ad",
    "terrorism"
  ],
  "note": "blabla"
}

正常なレスポンスの例

{
  "code": 200, 
  "msg": "OK", 
  "requestId": "EE5A1189-4D7B-4C24-AD78-4C1FAA3E7A0C"
}