QueryMediaCensorJobList でコンテンツ審査ジョブをクエリ - MPS

コンテンツモデレーションジョブのリストを照会します。

操作説明

この操作では、過去 3 か月以内に作成されたコンテンツモデレーションジョブを照会します。

QPS 制限

1 ユーザーあたりの 1 秒あたりのクエリ数 (QPS) 制限は 100 です。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響が及ぶ可能性があります。この操作は、適切な頻度で呼び出してください。詳細については、「QPS 制限」をご参照ください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mts:QueryMediaCensorJobList

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
JobIds	string	任意	コンテンツモデレーションジョブの ID。SubmitMediaCensorJob 操作のレスポンスパラメーターからジョブ ID を取得できます。複数の ID はコンマ (,) で区切ります。	fa9c34be3bcf42919ac4d1775239**,78dc866518b843259669df58ed30**
NextPageToken	string	任意	次のページの結果を取得するために使用されるトークン。最初のリクエストでは、このパラメーターを空のままにします。次のページのトークンは、最初のリクエストへの応答で返されます。	79aff3eee82242e092899db5f669****
MaximumPageSize	integer	任意	各ページで返される結果の最大数。デフォルト：30 有効な値：1～300	20
State	string	任意	照会するジョブの状態。有効な値： All：すべてのジョブ。 Queuing：キューイング中のジョブ。 Analysing：分析中のジョブ。 Fail：失敗したジョブ。 Success：成功したジョブ。	All
StartOfJobCreatedTimeRange	string	任意	作成時間によってジョブを照会する時間範囲の開始。日時は ISO 8601 形式で、UTC です。フォーマットは YYYY-MM-DDThh:mm:ssZ です。	2021-12-22T03:48:05Z
EndOfJobCreatedTimeRange	string	任意	作成時間によってジョブを照会する時間範囲の終了。日時は ISO 8601 形式で、UTC です。フォーマットは YYYY-MM-DDThh:mm:ssZ です。	2022-02-14T02:16:07Z
PipelineId	string	任意	MPS キューの ID。MPS キュー ID を取得するには、ApsaraVideo Media Processing コンソールにログインし、[グローバル設定] > [MPS キューとコールバック] を選択します。	c5b30b7c0d0e4a0abde1d5f9e751****

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーター。
MediaCensorJobList	object
MediaCensorJob	array<object>	コンテンツモデレーションジョブのリスト。
	array<object>	コンテンツモデレーションジョブの詳細。
CreationTime	string	ジョブが作成された時間。	2021-11-04T07:25:48Z
FinishTime	string	ジョブが完了した時間。	2021-11-04T07:25:48Z
Suggestion	string	推奨される操作。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。	pass
CoverImageCensorResults	object
CoverImageCensorResult	array<object>	サムネイルのモデレーション結果のリスト。
	array<object>	サムネイルのモデレーション結果の詳細。
Object	string	サムネイルの OSS オブジェクト。	test/ai/censor/v2/vme-****.jpg
Location	string	サムネイルの OSS ロケーション。	oss-cn-shanghai
Bucket	string	サムネイルの OSS バケット。	example-Bucket-****
Results	object
Result	array<object>	ジョブのモデレーション結果。
	object	モデレーション結果の詳細。
Suggestion	string	ジョブの全体的なモデレーション結果。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。説明いずれかのカテゴリのモデレーション結果が review の場合、全体の結果は review になります。いずれかのカテゴリのモデレーション結果が block の場合、全体の結果は block になります。	pass
Label	string	モデレーション結果のラベル。複数のラベルはコンマ (,) で区切ります。ポルノ検出 (porn) 結果のラベル： normal：正常 sexy：セクシー porn：ポルノテロ・政治関連コンテンツ検出 (terrorism) 結果のラベル： normal：正常 bloody：血なまぐさい explosion：爆発 outfit：特殊な服装 logo：特殊なロゴ weapon：武器 politics：政治的コンテンツ violence：暴力 crowd：群衆 parade：パレード carcrash：自動車事故 flag：旗 location：ランドマーク others：その他広告・テキスト違反検出 (ad) 結果のラベル： normal：正常 ad：その他の広告 politics：政治的コンテンツを含むテキスト porn：ポルノコンテンツを含むテキスト abuse：虐待的なコンテンツを含むテキスト terrorism：テロリストのコンテンツを含むテキスト contraband：禁制品コンテンツを含むテキスト spam：その他のスパム npx：皮膚病のような広告 qrcode：QR コード programCode：ミニアプリコード不快なシーン検出 (live) 結果のラベル： normal：正常 meaningless：画像にコンテンツがない (例：黒または白の画面) PIP：ピクチャーインピクチャー (PiP) smoking：喫煙 drivelive：車内でのライブストリーミングロゴ検出 (Logo) 結果のラベル： normal：正常 TV：規制対象のロゴが含まれている trademark：商標が含まれている	normal
Scene	string	モデレーションシナリオ。 porn：ポルノ検出 terrorism：テロ・政治関連コンテンツ検出 ad：広告・テキスト違反検出 live：不快なシーン検出 Logo：ロゴ検出	live
Rate	string	スコア。有効な値：0～100。	100
State	string	ジョブの状態。	Success
TitleCensorResult	object	タイトルのモデレーション結果。
Suggestion	string	推奨される操作。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。	block
Label	string	モデレーション結果のラベル。複数のラベルはコンマ (,) で区切ります。 normal：正常 spam：スパム ad：広告 politics：政治的コンテンツ terrorism：テロリストのコンテンツ abuse：虐待 porn：ポルノコンテンツ flood：フラッディング contraband：禁制品 meaningless：無意味 harmful：望ましくないシナリオ (金銭崇拝、ファンカルチャー、ネガティブな感情、ネガティブな誘導などを含みます。)	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：広告 politics：政治的コンテンツ terrorism：テロリストのコンテンツ abuse：虐待 porn：ポルノコンテンツ flood：フラッディング contraband：禁制品 meaningless：無意味 harmful：望ましくないシナリオ (金銭崇拝、ファンカルチャー、ネガティブな感情、ネガティブな誘導などを含みます。)	normal
Scene	string	モデレーションシナリオ。これは静的フィールドです。値：antispam。テキストスパム対策を示します。	antispam
Rate	string	スコア。	99.91
DescCensorResult	object	説明のモデレーション結果。
Suggestion	string	推奨される操作。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。	pass
Label	string	モデレーション結果のカテゴリ。複数のカテゴリはコンマ (,) で区切ります。有効な値： normal：正常 spam：スパム ad：広告 politics：政治的コンテンツ terrorism：テロリストのコンテンツ abuse：虐待 porn：ポルノコンテンツ flood：フラッディング contraband：禁制品 meaningless：無意味 harmful：望ましくないシナリオ (金銭崇拝、ファンカルチャー、ネガティブな感情、ネガティブな誘導などを含みます。)	ad
Scene	string	モデレーションシナリオ。これは静的フィールドです。値：antispam。テキストスパム対策を示します。	antispam
Rate	string	スコア。	100
VideoCensorConfig	object	動画モデレーション設定。
OutputFile	object	ビデオスナップショット結果のストレージロケーション。
Object	string	スナップショットの出力ファイル (OSS オブジェクト)。説明例では、{Count} はプレースホルダーです。イメージオブジェクトは、output00001-**.jpg や `output00002-**.jpg` のように順番に名前が付けられます。	output{Count}.jpg
Location	string	出力スナップショットが保存される OSS バケットの OSS ロケーション。	oss-cn-shanghai
Bucket	string	出力スナップショットが保存される OSS バケット。	test-bucket-****
VideoCensor	string	動画コンテンツをモデレーションするかどうかを示します。デフォルト値：true。有効な値： true：動画コンテンツをモデレーションします。 false：動画コンテンツをモデレーションしません。	true
BizType	string	モデレーションテンプレート。デフォルト値：common (デフォルトテンプレート)。説明このパラメーターを指定しない場合、デフォルト値の `common` が使用されます。チケットを起票してカスタムモデレーションテンプレートを使用する場合、テンプレートの UID が返されます。	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} はプレースホルダーです。イメージオブジェクトは、output00001-**.jpg や `output00002-**.jpg` のように順番に名前が付けられます。	output{Count}.jpg
CensorResults	object
CensorResult	array<object>	さまざまな種類のモデレーション結果のラベルとスコア。
	object	詳細。
Suggestion	string	推奨される操作。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。	block
Label	string	モデレーション結果のカテゴリ。複数のカテゴリはコンマ (,) で区切ります。有効な値：ポルノ検出 (porn) 結果のラベル： porn：ポルノ sexy：セクシー normal：正常テロ・政治関連コンテンツ検出 (terrorism) 結果のラベル： normal：正常 bloody：血なまぐさい explosion：爆発 outfit：特殊な服装 logo：特殊なロゴ weapon：武器 politics：政治的コンテンツ violence：暴力 crowd：群衆 parade：パレード carcrash：自動車事故 flag：旗 location：ランドマーク others：その他広告検出 (ad) 結果のラベル： normal：正常 ad：その他の広告 politics：政治的コンテンツを含むテキスト porn：ポルノコンテンツを含むテキスト abuse：虐待的なコンテンツを含むテキスト terrorism：テロリストのコンテンツを含むテキスト contraband：禁制品コンテンツを含むテキスト spam：その他のスパム npx：皮膚病のような広告 qrcode：QR コード programCode：ミニアプリコード不快なシーン検出 (live) 結果のラベル： normal：正常 meaningless：画像にコンテンツがない (例：黒または白の画面) PIP：ピクチャーインピクチャー (PiP) smoking：喫煙 drivelive：車内でのライブストリーミングロゴ検出 (logo) 結果のラベル： normal：正常 TV：規制対象のロゴが含まれている trademark：商標が含まれている	normal
Scene	string	モデレーションシナリオ。 porn：ポルノ検出 terrorism：テロ・政治関連コンテンツ検出 ad：広告・テキスト違反検出 live：不快なシーン検出 logo：ロゴ検出	pron
Rate	string	スコア。	99.99
NextPageToken	string	次のページのトークン。	ea04afcca7cd4e80b9ece8fbb251****
CensorResults	object
CensorResult	array<object>	ポルノ、テロ、政治的コンテンツなど、さまざまなシナリオの概要情報を含むモデレーション結果のコレクション。
	object	モデレーション結果の詳細。
Suggestion	string	推奨される操作。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。	review
Label	string	モデレーション結果のカテゴリ。複数のカテゴリはコンマ (,) で区切ります。有効な値：ポルノ検出 (porn) 結果のラベル： porn：ポルノ sexy：セクシー normal：正常テロ・政治関連コンテンツ検出 (terrorism) 結果のラベル： normal：正常 bloody：血なまぐさい explosion：爆発 outfit：特殊な服装 logo：特殊なロゴ weapon：武器 politics：政治的コンテンツ violence：暴力 crowd：群衆 parade：パレード carcrash：自動車事故 flag：旗 location：ランドマーク others：その他広告検出 (ad) 結果のラベル： normal：正常 ad：その他の広告 politics：政治的コンテンツを含むテキスト porn：ポルノコンテンツを含むテキスト abuse：虐待的なコンテンツを含むテキスト terrorism：テロリストのコンテンツを含むテキスト contraband：禁制品コンテンツを含むテキスト spam：その他のスパム npx：皮膚病のような広告 qrcode：QR コード programCode：ミニアプリコード不快なシーン検出 (live) 結果のラベル： normal：正常 meaningless：画像にコンテンツがない (例：黒または白の画面) PIP：ピクチャーインピクチャー (PiP) smoking：喫煙 drivelive：車内でのライブストリーミングロゴ検出 (logo) 結果のラベル： normal：正常 TV：規制対象のロゴが含まれている trademark：商標が含まれている	meaningless
Scene	string	モデレーションシナリオ。 porn：ポルノ検出 terrorism：テロ・政治関連コンテンツ検出 ad：広告・テキスト違反検出 live：不快なシーン検出 logo：ロゴ検出	terrorism
Rate	string	スコア。	100
AudioCensorResult	object	音声モデレーション結果。
Suggestion	string	推奨される操作。有効な値： pass：コンテンツは合格です。 review：コンテンツは手動でレビューする必要があります。 block：コンテンツはブロックする必要があります。	pass
Label	string	検出結果のカテゴリ。有効な値： normal：正常なテキスト spam：スパム ad：広告 politics：政治的コンテンツ terrorism：テロリストのコンテンツ abuse：虐待 porn：ポルノコンテンツ flood：フラッディング contraband：禁制品 meaningless：無意味 harmful：望ましくないシナリオ (金銭崇拝、ファンカルチャー、ネガティブな感情、ネガティブな誘導などを含みます。)	normal
PipelineId	string	MPS キューの ID。	c5b30b7c0d0e4a0abde1d5f9e751****
RequestId	string	リクエスト ID。	D1D5C080-8E2F-5030-8AB4-13092F17631B
NextPageToken	string	次のページのトークン。これは 32 ビットの汎用一意識別子 (UUID) です。このパラメーターは、クエリ結果が複数ページにまたがる場合に返されます。このパラメーターの値は、クエリごとに更新されます。	9b1a42bc6e8d46e6a1383b7e7f01****
NonExistIds	object
String	array	存在しないジョブ ID のリスト。指定されたすべてのジョブ ID が存在する場合、このパラメーターは返されません。
	string	ジョブ ID。	78dc866518b843259669df58ed30****

例

成功レスポンス

JSONJSON

{
  "MediaCensorJobList": {
    "MediaCensorJob": [
      {
        "CreationTime": "2021-11-04T07:25:48Z",
        "FinishTime": "2021-11-04T07:25:48Z",
        "Suggestion": "pass",
        "CoverImageCensorResults": {
          "CoverImageCensorResult": [
            {
              "Object": "test/ai/censor/v2/vme-****.jpg",
              "Location": "oss-cn-shanghai",
              "Bucket": "example-Bucket-****",
              "Results": {
                "Result": [
                  {
                    "Suggestion": "pass",
                    "Label": "normal",
                    "Scene": "live",
                    "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": "pass",
          "Label": "ad",
          "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": "normal",
                      "Scene": "pron",
                      "Rate": "99.99"
                    }
                  ]
                }
              }
            ]
          },
          "NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
          "CensorResults": {
            "CensorResult": [
              {
                "Suggestion": "review",
                "Label": "meaningless",
                "Scene": "terrorism",
                "Rate": "100"
              }
            ]
          }
        },
        "AudioCensorResult": {
          "Suggestion": "pass",
          "Label": "normal"
        },
        "PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
      }
    ]
  },
  "RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B",
  "NextPageToken": "9b1a42bc6e8d46e6a1383b7e7f01****",
  "NonExistIds": {
    "String": [
      "78dc866518b843259669df58ed30****"
    ]
  }
}

エラーコード

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

変更履歴

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