コンテンツモデレーションジョブの詳細を照会します。
操作説明
コンテンツモデレーション結果では、動画セクションが時刻順（昇順）に並べられてタイムラインが形成されます。動画の再生時間が非常に長い場合、照会時に結果の最初のページのみが返されます。動画セクションの完全な結果を取得するには、本 API を個別に呼び出してください。
クエリ/秒 (QPS) 制限
本 API の QPS 制限は、ユーザーあたり 100 クエリ/秒です。この制限を超えると、レート制限が適用され、ビジネスに影響を及ぼす可能性があります。API を適切に呼び出してください。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:QueryMediaCensorJobDetail |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| JobId |
string |
必須 |
コンテンツモデレーションジョブの ID です。このジョブ ID は、SubmitMediaCensorJob 操作の応答パラメーターから取得できます。 |
2288c6ca184c0e47098a5b665e2a12**** |
| NextPageToken |
string |
任意 |
次のページの結果を取得するための次のリクエストで使用されるページネーショントークンです。最初のリクエストでは、このパラメーターを指定する必要はありません。コンテンツモデレーションジョブの結果を初めて照会した際に、次のページのトークンが応答として返されます。 |
ae0fd49c0840e14daf0d66a75b83**** |
| MaximumPageSize |
integer |
任意 |
各ページで返される最大エントリー数です。
|
30 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーターです。 |
||
| RequestId |
string |
リクエストの ID です。 |
B42299E6-F71F-465F-8FE9-4FC2E3D3C2CA |
| MediaCensorJobDetail |
object |
コンテンツモデレーションジョブの結果です。 |
|
| CreationTime |
string |
ジョブが作成された時刻です。 |
2018-09-13T16:32:24Z |
| FinishTime |
string |
ジョブが完了した時刻です。 |
2018-09-21 |
| Suggestion |
string |
ジョブ全体の判定結果です。有効な値は以下のとおりです。
いずれかのモデレーション対象コンテンツの判定結果が 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 |
| Label |
string |
モデレーション結果のラベルです。複数のラベルはカンマ (,) で区切られます。
|
normal |
| Scene |
string |
モデレーションのシナリオです。有効な値は以下のとおりです。
|
porn |
| 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 |
ジョブが失敗した場合に返されるエラーメッセージです。ジョブが成功した場合は、このパラメーターは返されません。 |
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 |
| Label |
string |
モデレーション結果のラベルです。複数のラベルはカンマ (,) で区切られます。有効な値は以下のとおりです。
|
normal |
| Scene |
string |
モデレーションのシナリオです。有効な値は antispam です。 |
antispam |
| Rate |
string |
スコアです。 |
99.91 |
| DescCensorResult |
object |
説明文のモデレーション結果です。 |
|
| Suggestion |
string |
推奨される後続操作です。有効な値は以下のとおりです。
|
review |
| Label |
string |
モデレーション結果のラベルです。有効な値は以下のとおりです。
|
normal |
| Scene |
string |
モデレーションのシナリオです。有効な値は antispam です。 |
antispam |
| Rate |
string |
スコアです。 |
100 |
| VideoCensorConfig |
object |
動画モデレーションの構成です。 |
|
| OutputFile |
object |
出力スナップショットに関する情報です。 |
|
| Object |
string |
出力スナップショットとして生成される 1 つ以上の OSS オブジェクトです。 説明
例では、{Count} はプレースホルダーです。出力スナップショットとして生成される OSS オブジェクトの名前は、 |
output{Count}.jpg |
| Location |
string |
出力スナップショットを格納している OSS バケットのリージョンです。 |
oss-cn-shanghai |
| Bucket |
string |
出力スナップショットを格納している OSS バケットです。 |
test-bucket-**** |
| VideoCensor |
string |
動画コンテンツのモデレーションが必要かどうかを示します。デフォルト値：true。有効な値は以下のとおりです。
|
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 |
動画内の位置です。形式： |
00:02:59.999 |
| Object |
string |
出力スナップショットとして生成される 1 つ以上の OSS オブジェクトです。 説明
例では、{Count} はプレースホルダーです。出力スナップショットとして生成される OSS オブジェクトの名前は、 |
output{Count}.jpg |
| CensorResults |
object |
||
| CensorResult |
array<object> |
ラベルやスコアなどの情報を含むモデレーション結果です。 |
|
|
object |
応答パラメーターです。 |
||
| Suggestion |
string |
推奨される後続操作です。有効な値は以下のとおりです。
|
block |
| Label |
string |
モデレーション結果のラベルです。複数のラベルはカンマ (,) で区切られます。有効な値は以下のとおりです。
|
porn,ad |
| Scene |
string |
モデレーションのシナリオです。有効な値は以下のとおりです。
|
porn |
| Rate |
string |
スコアです。 |
99.99 |
| NextPageToken |
string |
NextToken の戻り値はページネーショントークンであり、次のリクエストで新しいページの結果を取得するために使用できます。 |
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 |
| AudioDetailResultList |
object |
||
| AudioDetailResult |
array<object> |
詳細な音声レビュー結果です。 |
|
|
object |
結果の内容です。 |
||
| StartTime |
integer |
文の開始時刻（秒単位）です。 |
0 |
| EndTime |
integer |
文の終了時刻（秒単位）です。 |
30 |
| Text |
string |
音声をテキストに変換した結果です。 |
测试一下 |
| Label |
string |
検出結果の分類です。有効な値は以下のとおりです。
|
normal |
| 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-21",
"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": "porn",
"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": "normal",
"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": "porn,ad",
"Scene": "porn",
"Rate": "99.99"
}
]
}
}
]
},
"NextPageToken": "ea04afcca7cd4e80b9ece8fbb251****",
"CensorResults": {
"CensorResult": [
{
"Suggestion": "review",
"Label": "meaningless",
"Scene": "terrorism",
"Rate": "100"
}
]
}
},
"AudioCensorResult": {
"Suggestion": "pass",
"Label": "normal",
"AudioDetailResultList": {
"AudioDetailResult": [
{
"StartTime": 0,
"EndTime": 30,
"Text": "测试一下",
"Label": "normal"
}
]
}
},
"PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。