コンテンツモデレーションタスクのリストを照会します。
操作説明
この操作では、過去 3 か月以内に作成されたコンテンツモデレーションタスクのみをクエリできます。
QPS 制限
この操作は、アカウントあたり 1 秒間に最大 100 回呼び出せます。1 秒あたりの呼び出し回数が制限を超えると、速度制限がトリガーされます。これにより、ビジネスに影響が出る可能性があります。詳細については、「QPS 制限」を参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:QueryMediaCensorJobList |
get |
*すべてのリソース。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| JobIds |
string |
任意 |
コンテンツモデレーションタスクの ID。 SubmitMediaCensorJob 操作の応答から ID を取得できます。複数の ID はコンマ (,) で区切ります。 |
fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30**** |
| NextPageToken |
string |
任意 |
ページネーショントークン。最初のリクエストでは、このパラメーターを空にします。ページネーショントークンは、最初のクエリ後に返されます。 |
79aff3eee82242e092899db5f669**** |
| MaximumPageSize |
integer |
任意 |
1 ページあたりに返すエントリの最大値。
|
20 |
| State |
string |
任意 |
クエリするタスクのステータス。有効な値:
|
All |
| StartOfJobCreatedTimeRange |
string |
任意 |
タスクの最も早い作成時間。
|
2021-12-22T03:48:05Z |
| EndOfJobCreatedTimeRange |
string |
任意 |
タスクの最も遅い作成時間。
|
2022-02-14T02:16:07Z |
| PipelineId |
string |
任意 |
MPS キューの ID。ApsaraVideo Media Processing コンソール で グローバル設定項目 > パイプラインとコールバック に移動して、ID を取得できます。 |
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 |
| 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 |
タスクの全体的なモデレーション結果。有効な値:
説明
いずれかのモデレーションタイプが review を返した場合、全体的な結果は review になります。いずれかのモデレーションタイプが block を返した場合、全体的な結果は block になります。 |
pass |
| Label |
string |
モデレーション結果のラベル。複数のラベルはカンマ (,) で区切られます。
|
normal |
| Scene |
string |
モデレーションシナリオ。有効な値:
|
live |
| Rate |
string |
スコア。有効な値: 0 ～ 100。 |
100 |
| State |
string |
タスクのステータス。 |
Success |
| TitleCensorResult |
object |
タイトルのモデレーション結果。 |
|
| Suggestion |
string |
推奨される操作。有効な値:
|
block |
| Label |
string |
モデレーション結果のラベル。複数のラベルはカンマ (,) で区切られます。
|
meaningless |
| Scene |
string |
モデレーションシナリオ。固定値: antispam (テキストの迷惑メール対策を示す)。 |
antispam |
| Rate |
string |
スコア。 |
99.91 |
| Message |
string |
タスクが失敗したときに返されるエラーメッセージ。タスクが成功した場合は、このパラメーターは返されません。 |
操作されたリソースが見つかりません |
| 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 |
| Label |
string |
モデレーション結果のラベル。複数のラベルはカンマ (,) で区切られます。有効な値:
|
normal |
| Scene |
string |
モデレーションシナリオ。固定値: antispam (テキストの迷惑メール対策を示す)。 |
antispam |
| Rate |
string |
スコア。 |
99.91 |
| DescCensorResult |
object |
説明のモデレーション結果。 |
|
| Suggestion |
string |
推奨される操作。有効な値:
|
pass |
| Label |
string |
モデレーション結果のラベル。複数のラベルはカンマ (,) で区切られます。有効な値:
|
ad |
| Scene |
string |
モデレーションシナリオ。固定値: antispam (テキストの迷惑メール対策を示す)。 |
antispam |
| Rate |
string |
スコア。 |
100 |
| VideoCensorConfig |
object |
ビデオモデレーションの構成。 |
|
| OutputFile |
object |
ビデオスナップショット結果のストレージの場所。 |
|
| Object |
string |
スナップショットの出力ファイル (OSS オブジェクト)。 説明
例では、{Count} はプレースホルダーです。イメージオブジェクトは |
output{Count}.jpg |
| Location |
string |
スナップショット出力用の OSS バケットの OSS ロケーション。 |
oss-cn-shanghai |
| Bucket |
string |
スナップショット出力ファイル用の OSS バケット。 |
test-bucket-**** |
| VideoCensor |
string |
ビデオコンテンツをモデレーションするかどうかを指定します。デフォルト値: true。有効な値:
|
true |
| BizType |
string |
モデレーションテンプレート。デフォルト値: common (デフォルトテンプレート)。 説明
このパラメーターが指定されていない場合、デフォルト値の common が使用されます。チケットを提出してカスタムモデレーションテンプレートが作成されている場合、このパラメーターは UID を返します。 |
common |
| JobId |
string |
コンテンツモデレーションタスクの ID。 |
f8f166eea7a44e9bb0a4aecf9543**** |
| UserData |
string |
カスタムデータ。 |
サンプルユーザーデータ **** |
| Code |
string |
タスクが失敗したときに返されるエラーコード。タスクが成功した場合は、このパラメーターは返されません。 |
InvalidParameter.ResourceNotFound |
| VensorCensorResult |
object |
ビデオモデレーション結果。 |
|
| VideoTimelines |
object |
||
| VideoTimeline |
array<object> |
特定のタイムスタンプでのモデレーション結果。時間の昇順でソートされています。 |
|
|
array<object> |
詳細。 |
||
| Timestamp |
string |
ビデオ内の位置。フォーマット: |
00:02:59.999 |
| Object |
string |
スナップショットの出力ファイル (OSS オブジェクト)。 説明
例では、{Count} はプレースホルダーです。イメージオブジェクトは |
output{Count}.jpg |
| CensorResults |
object |
||
| CensorResult |
array<object> |
複数のモデレーションタイプのラベル、スコア、フォーマット、およびその他の情報。 |
|
|
object |
詳細。 |
||
| Suggestion |
string |
推奨される操作。有効な値：
|
block |
| Label |
string |
モデレーション結果のカテゴリ。複数のカテゴリはコンマ (,) で区切ります。有効な値：
|
normal |
| Scene |
string |
モデレーションシナリオ。
|
pron |
| Rate |
string |
スコア。 |
99.99 |
| NextPageToken |
string |
次のページのトークン。 |
ea04afcca7cd4e80b9ece8fbb251**** |
| CensorResults |
object |
||
| CensorResult |
array<object> |
モデレーション結果のコレクション。ポルノ、暴力、テロ、政治的コンテンツなど、さまざまなシナリオのまとめとフォーマットが含まれています。 |
|
|
object |
モデレーション結果の詳細。 |
||
| Suggestion |
string |
推奨される操作。有効な値:
|
review |
| Label |
string |
モデレーション結果のラベル。複数のラベルはカンマ (,) で区切られます。有効な値:
|
meaningless |
| Scene |
string |
モデレーションシナリオ。有効な値:
|
terrorism |
| Rate |
string |
スコア。 |
100 |
| AudioCensorResult |
object |
音声モデレーション結果。 |
|
| Suggestion |
string |
推奨される操作。有効な値:
|
pass |
| Label |
string |
検出結果のラベル。有効な値:
|
normal |
| PipelineId |
string |
MPS キュー ID。 |
c5b30b7c0d0e4a0abde1d5f9e751**** |
| RequestId |
string |
リクエスト ID。 |
D1D5C080-8E2F-5030-8AB4-13092F17631B |
| NextPageToken |
string |
次のページのトークン。これは 32 ビットの UUID です。クエリ結果が複数ページにスパンする場合に、このパラメーターが返されます。値はクエリごとに更新されます。 |
9b1a42bc6e8d46e6a1383b7e7f01**** |
| NonExistIds |
object |
||
| String |
array |
存在しないタスク 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****"
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。