コンテンツモデレーションタスクの詳細をクエリする方法 - Intelligent Media Services (IMS)

コンテンツ審査ジョブの情報を照会します。

操作説明

コンテンツ審査結果では、ビデオの審査結果が時間順に昇順でタイムラインにソートされます。ビデオが長い場合、コンテンツ審査結果はページ分割され、最初のページが返されます。残りのビデオ審査結果を照会するには、この操作を再度呼び出すことができます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:QueryMediaCensorJobDetail

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
JobId	string	必須	コンテンツ審査ジョブの ID。ジョブ ID は、SubmitMediaCensorJob 操作のレスポンスパラメーターから取得できます。	2288c6ca184c0e47098a5b665e2a12****
NextPageToken	string	任意	次のリクエストで新しい結果ページを取得するために使用されるページネーショントークン。最初のリクエストでは、このパラメーターを指定する必要はありません。以前のクエリから取得したトークンを NextToken の値として指定する必要があります。	ae0fd49c0840e14daf0d66a75b83****
MaximumPageSize	integer	任意	1 ページあたりのエントリ数。デフォルト値：30。有効な値：1 から 300。	30

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
RequestId	string	リクエスト ID。	B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA
MediaCensorJobDetail	object	コンテンツ審査ジョブの結果。
CreationTime	string	コンテンツ審査ジョブが作成された時間。	2018-09-13T16:32:24Z
FinishTime	string	コンテンツ審査ジョブが完了した時間。	2018-09-13T16:38:24Z
Suggestion	string	コンテンツ審査ジョブの全体的な結果。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。説明いずれかのタイプのコンテンツの審査結果が「review」の場合、全体的な結果は「review」です。いずれかのタイプのコンテンツの審査結果が「block」の場合、全体的な結果は「block」です。	block
CoverImageCensorResults	object
CoverImageCensorResult	array<object>	サムネイルの審査結果。
	array<object>	詳細な結果。
Object	string	サムネイルとして使用される Object Storage Service (OSS) オブジェクト。	test/ai/censor/v2/vme-****.jpg
Location	string	サムネイルが存在する OSS リージョン。	oss-cn-shanghai
Bucket	string	サムネイルが保存されている OSS バケット。	bucket-out-test-****
Results	object
Result	array<object>	審査結果。
	object	詳細な審査結果。
Suggestion	string	推奨される後続の操作。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。	pass
Label	string	審査結果のラベル。ポルノコンテンツ審査シナリオでの有効な値： normal：正常なコンテンツ。 sexy：性的なコンテンツ。 porn：ポルノコンテンツ。テロリストコンテンツ審査シナリオでの有効な値： normal：正常なコンテンツ。 bloody：血なまぐさいコンテンツ。 explosion：爆発と煙。 outfit：特別な衣装。 logo：特別なロゴ。 weapon：武器。 politics：政治的コンテンツ。 violence：暴力。 crowd：群衆。 parade：パレード。 carcrash：自動車事故。 flag：旗。 location：ランドマーク。 others：その他のコンテンツ。広告審査シナリオでの有効な値： normal：正常なコンテンツ。 ad：その他の広告。 politics：テキスト内の政治的コンテンツ。 porn：テキスト内のポルノコンテンツ。 abuse：テキスト内の虐待。 terrorism：テキスト内のテロリストコンテンツ。 contraband：テキスト内の禁止コンテンツ。 spam：テキスト内の迷惑メール。 npx：違法広告。 qrcode：QR コード。 programCode：ミニプログラムコード。不適切なシーン審査シナリオでの有効な値： normal：正常なコンテンツ。 meaningless：意味のないコンテンツ (黒または白の画面など)。 PIP：ピクチャーインピクチャー。 smoking：喫煙。 drivelive：走行中の車両でのライブ放送。ロゴ審査シナリオでの有効な値： normal：正常なコンテンツ。 TV：制御されたロゴ。 trademark：商標。	Normal
Scene	string	審査シナリオ。有効な値： porn：ポルノコンテンツ審査。 terrorism：テロリストコンテンツ審査。 ad：広告審査。 live：不適切なシーン審査。 logo：ロゴ審査。	Antispam
Rate	string	スコア。有効な値：0 から 100。	100
State	string	ジョブの状態。	Success
TitleCensorResult	object	タイトルの審査結果。
Suggestion	string	推奨される後続の操作。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。	block
Label	string	審査結果のラベル。有効な値： normal：正常なコンテンツ。 spam：迷惑メール。 ad：広告。 abuse：虐待コンテンツ。 flood：過剰なジャンクコンテンツ。 contraband：禁止コンテンツ。 meaningless：意味のないコンテンツ。	meaningless
Scene	string	審査シナリオ。値は antispam です。	antispam
Rate	string	スコア。	99.91
Message	string	ジョブが失敗した場合に返されるエラーメッセージ。ジョブが成功した場合、このパラメーターは返されません。	The resource operated cannot be found
Input	object	ジョブ入力に関する情報。
Object	string	入力ファイルとして使用される OSS オブジェクトの名前。	test/ai/censor/test-****.mp4
Location	string	入力ファイルが存在する OSS リージョン。	oss-cn-shanghai
Bucket	string	入力ファイルが保存されている OSS バケットの名前。	bucket-test-in-****
BarrageCensorResult	object	弾幕の審査結果。
Suggestion	string	推奨される後続の操作。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。	pass
Label	string	審査結果のラベル。有効な値： normal：正常なコンテンツ。 spam：迷惑メール。 ad：広告。 abuse：虐待コンテンツ。 flood：過剰なジャンクコンテンツ。 contraband：禁止コンテンツ。 meaningless：意味のないコンテンツ。	normal
Scene	string	審査シナリオ。値は antispam です。	antispam
Rate	string	スコア。	99.91
DescCensorResult	object	説明の審査結果。
Suggestion	string	推奨される後続の操作。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。	review
Label	string	審査結果のラベル。有効な値： normal：正常なコンテンツ。 spam：迷惑メール。 ad：広告。 abuse：虐待コンテンツ。 flood：過剰なジャンクコンテンツ。 contraband：禁止コンテンツ。 meaningless：意味のないコンテンツ。	terrorism
Scene	string	審査シナリオ。値は antispam です。	antispam
Rate	string	スコア。	100
VideoCensorConfig	object	ビデオ審査構成。
OutputFile	object	出力スナップショットに関する情報。
Object	string	出力スナップショットとして生成される OSS オブジェクト。説明例では、{Count} はプレースホルダーです。出力スナップショットとして生成される OSS オブジェクトは、`output00001-**.jpg`、`output00002-**.jpg` などと命名されます。	output{Count}.jpg
Location	string	出力スナップショットが存在する OSS リージョン。	oss-cn-shanghai
Bucket	string	出力スナップショットが保存されている OSS バケット。	test-bucket-****
VideoCensor	string	ビデオコンテンツを審査する必要があるかどうかを示します。デフォルト値：true。有効な値： true：ビデオコンテンツを審査する必要があります。 false：ビデオコンテンツを審査する必要はありません。	true
BizType	string	カスタムビジネスタイプ。デフォルト値：common。	common
JobId	string	コンテンツ審査ジョブの ID。	f8f166eea7a44e9bb0a4aecf9543****
UserData	string	ユーザー定義データ。	example userdata ****
Code	string	ジョブが失敗した場合に返されるエラーコード。ジョブが成功した場合、このパラメーターは返されません。	InvalidParameter.ResourceNotFound
VensorCensorResult	object	ビデオの審査結果。
VideoTimelines	object
VideoTimeline	array<object>	時間順に昇順でソートされた審査結果。
	array<object>	レスポンスパラメーター。
Timestamp	string	ビデオ内の位置。フォーマット：`hh:mm:ss[.SSS]`。	00:02:59.999
Object	string	出力スナップショットとして生成される OSS オブジェクト。説明例では、{Count} はプレースホルダーです。出力スナップショットとして生成される OSS オブジェクトは、`output00001-**.jpg`、`output00002-**.jpg` などと命名されます。	output{Count}.jpg
CensorResults	object
CensorResult	array<object>	ラベルやスコアなどの情報を含む審査結果。
	object	レスポンスパラメーター。
Suggestion	string	推奨される後続の操作。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。	block
Label	string	審査結果のラベル。ポルノコンテンツ審査シナリオでの有効な値： normal：正常なコンテンツ。 sexy：性的なコンテンツ。 porn：ポルノコンテンツ。テロリストコンテンツ審査シナリオでの有効な値： normal：正常なコンテンツ。 bloody：血なまぐさいコンテンツ。 explosion：爆発と煙。 outfit：特別な衣装。 logo：特別なロゴ。 weapon：武器。 politics：政治的コンテンツ。 violence：暴力。 crowd：群衆。 parade：パレード。 carcrash：自動車事故。 flag：旗。 location：ランドマーク。 others：その他のコンテンツ。広告審査シナリオでの有効な値： normal：正常なコンテンツ。 ad：その他の広告。 politics：テキスト内の政治的コンテンツ。 porn：テキスト内のポルノコンテンツ。 abuse：テキスト内の虐待。 terrorism：テキスト内のテロリストコンテンツ。 contraband：テキスト内の禁止コンテンツ。 spam：テキスト内の迷惑メール。 npx：違法広告。 qrcode：QR コード。 programCode：ミニプログラムコード。不適切なシーン審査シナリオでの有効な値： normal：正常なコンテンツ。 meaningless：意味のないコンテンツ (黒または白の画面など)。 PIP：ピクチャーインピクチャー。 smoking：喫煙。 drivelive：走行中の車両でのライブ放送。ロゴ審査シナリオでの有効な値： normal：正常なコンテンツ。 TV：制御されたロゴ。 trademark：商標。	flood
Scene	string	審査シナリオ。有効な値： porn：ポルノコンテンツ審査。 terrorism：テロリストコンテンツ審査。 ad：広告審査。 live：不適切なシーン審査。 logo：ロゴ審査。	porn
Rate	string	スコア。	99.99
NextPageToken	string	ページネーショントークン。次のリクエストで新しい結果ページを取得するために使用できます。	ea04afcca7cd4e80b9ece8fbb251****
CensorResults	object
CensorResult	array<object>	審査結果のコレクション。情報には、ポルノコンテンツ審査やテロリストコンテンツ審査などのさまざまなシナリオに関するまとめが含まれます。
	object	詳細な審査結果。
Suggestion	string	推奨される後続の操作。有効な値： pass：コンテンツは審査に合格します。 review：コンテンツは手動レビューが必要です。 block：コンテンツはブロックする必要があります。	review
Label	string	審査結果のラベル。ポルノコンテンツ審査シナリオでの有効な値： normal：正常なコンテンツ。 sexy：性的なコンテンツ。 porn：ポルノコンテンツ。テロリストコンテンツ審査シナリオでの有効な値： normal：正常なコンテンツ。 bloody：血なまぐさいコンテンツ。 explosion：爆発と煙。 outfit：特別な衣装。 logo：特別なロゴ。 weapon：武器。 politics：政治的コンテンツ。 violence：暴力。 crowd：群衆。 parade：パレード。 carcrash：自動車事故。 flag：旗。 location：ランドマーク。 others：その他のコンテンツ。広告審査シナリオでの有効な値： normal：正常なコンテンツ。 ad：その他の広告。 politics：テキスト内の政治的コンテンツ。 porn：テキスト内のポルノコンテンツ。 abuse：テキスト内の虐待。 terrorism：テキスト内のテロリストコンテンツ。 contraband：テキスト内の禁止コンテンツ。 spam：テキスト内の迷惑メール。 npx：違法広告。 qrcode：QR コード。 programCode：ミニプログラムコード。不適切なシーン審査シナリオでの有効な値： normal：正常なコンテンツ。 meaningless：意味のないコンテンツ (黒または白の画面など)。 PIP：ピクチャーインピクチャー。 smoking：喫煙。 drivelive：走行中の車両でのライブ放送。ロゴ審査シナリオでの有効な値： normal：正常なコンテンツ。 TV：制御されたロゴ。 trademark：商標。	meaningless
Scene	string	審査シナリオ。有効な値： porn：ポルノコンテンツ審査。 terrorism：テロリストコンテンツ審査。 ad：広告審査。 live：不適切なシーン審査。 logo：ロゴ審査。	terrorism
Rate	string	スコア。	100
PipelineId	string	ジョブが送信された ApsaraVideo Media Processing (MPS) キューの ID。	c5b30b7c0d0e4a0abde1d5f9e751****

例

成功レスポンス

JSONJSON

{
  "RequestId": "B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA",
  "MediaCensorJobDetail": {
    "CreationTime": "2018-09-13T16:32:24Z",
    "FinishTime": "2018-09-13T16:38:24Z",
    "Suggestion": "block",
    "CoverImageCensorResults": {
      "CoverImageCensorResult": [
        {
          "Object": "test/ai/censor/v2/vme-****.jpg",
          "Location": "oss-cn-shanghai",
          "Bucket": "bucket-out-test-****",
          "Results": {
            "Result": [
              {
                "Suggestion": "pass",
                "Label": "Normal",
                "Scene": "Antispam",
                "Rate": "100"
              }
            ]
          }
        }
      ]
    },
    "State": "Success",
    "TitleCensorResult": {
      "Suggestion": "block",
      "Label": "meaningless",
      "Scene": "antispam",
      "Rate": "99.91"
    },
    "Message": "The resource operated cannot be found",
    "Input": {
      "Object": "test/ai/censor/test-****.mp4",
      "Location": "oss-cn-shanghai",
      "Bucket": "bucket-test-in-****"
    },
    "BarrageCensorResult": {
      "Suggestion": "pass",
      "Label": "normal",
      "Scene": "antispam",
      "Rate": "99.91"
    },
    "DescCensorResult": {
      "Suggestion": "review",
      "Label": "terrorism",
      "Scene": "antispam",
      "Rate": "100"
    },
    "VideoCensorConfig": {
      "OutputFile": {
        "Object": "output{Count}.jpg",
        "Location": "oss-cn-shanghai",
        "Bucket": "test-bucket-****"
      },
      "VideoCensor": "true",
      "BizType": "common"
    },
    "JobId": "f8f166eea7a44e9bb0a4aecf9543****",
    "UserData": "example userdata ****",
    "Code": "InvalidParameter.ResourceNotFound",
    "VensorCensorResult": {
      "VideoTimelines": {
        "VideoTimeline": [
          {
            "Timestamp": "00:02:59.999",
            "Object": "output{Count}.jpg",
            "CensorResults": {
              "CensorResult": [
                {
                  "Suggestion": "block",
                  "Label": "flood",
                  "Scene": "porn",
                  "Rate": "99.99"
                }
              ]
            }
          }
        ]
      },
      "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
      "CensorResults": {
        "CensorResult": [
          {
            "Suggestion": "review",
            "Label": "meaningless",
            "Scene": "terrorism",
            "Rate": "100"
          }
        ]
      }
    },
    "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。