調用QueryMediaCensorJobList查詢媒體審核作業列表。
介面說明
本介面只支援查詢三個月內的媒體審核作業列表。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ice:QueryMediaCensorJobList |
get |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| JobIds |
string |
否 |
媒體審核作業 ID。可以從提交媒體審核作業的返回參數中擷取,多個使用半形逗號(,)分隔。 |
fa9c34be3bcf42919ac4d1775239****,78dc866518b843259669df58ed30**** |
| NextPageToken |
string |
否 |
下一頁標識,第一次提交時為空白即可。下一頁標識將在第一次查詢後返回。 |
79aff3eee82242e092899db5**** |
| MaximumPageSize |
integer |
否 |
每頁最大返回數。
|
20 |
| State |
string |
否 |
需要查詢的作業狀態。取值:
|
All |
| StartOfJobCreatedTimeRange |
string |
否 |
最早任務建立時間。
|
2021-12-22T03:48:05Z |
| EndOfJobCreatedTimeRange |
string |
否 |
最晚任務建立時間。
|
2022-02-14T02:16:07Z |
| PipelineId |
string |
否 |
管道 ID。 |
c5b30b7c0d0e4a0abde1d5f9e751**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回參數。 |
||
| MediaCensorJobList |
object |
||
| MediaCensorJob |
array<object> |
媒體審核作業列表。 |
|
|
array<object> |
媒體審核作業詳細資料。 |
||
| CreationTime |
string |
任務建立時間。 |
2021-11-04T07:25:48Z |
| FinishTime |
string |
完成時間。 |
2021-11-04T07:25:50Z |
| Suggestion |
string |
處理建議。可取值:
|
pass |
| CoverImageCensorResults |
object |
||
| CoverImageCensorResult |
array<object> |
封面圖片審查結果清單。 |
|
|
array<object> |
封面圖片審查結果詳細資料。 |
||
| Object |
string |
封面圖片的 OSS Object。 |
test/ai/censor/v2/vme-****.jpg |
| Location |
string |
封面圖片的 OSS Object。 |
oss-cn-shanghai |
| Bucket |
string |
封面圖片的 OSS Bucket。 |
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 |
分值。可取值:0~100。 |
100 |
| Message |
string |
作業失敗時錯誤資訊。執行成功時不返回此參數。 |
The resource operated cannot be found |
| Input |
object |
作業輸入。 |
|
| Object |
string |
輸入檔案的 OSS Object。 |
test/ai/censor/test-****.mp4 |
| Location |
string |
輸入檔案的 OSS Location。 |
oss-cn-shanghai |
| Bucket |
string |
輸入檔案的 OSS Bucket。 |
bucket-test-in-**** |
| BarrageCensorResult |
object |
彈幕審核結果。 |
|
| Suggestion |
string |
處理建議。取值:
|
pass |
| Label |
string |
審核結果的標籤,多個使用半形逗號(,)分隔。
|
normal |
| Scene |
string |
審核情境。取固定值:antispam,文本反垃圾。 |
antispam |
| Rate |
string |
分值。可取值:0~100。 |
99.91 |
| DescCensorResult |
object |
描述審核結果。 |
|
| Suggestion |
string |
處理建議。取值:
|
pass |
| Label |
string |
審核結果的標籤,多個使用半形逗號(,)分隔。
|
normal |
| Scene |
string |
審核情境。取固定值:antispam,文本反垃圾。 |
antispam |
| Rate |
string |
分值。可取值:0~100。 |
100 |
| VideoCensorConfig |
object |
視頻審查配置。 |
|
| OutputFile |
object |
視頻截圖結果的儲存地址。 |
|
| Object |
string |
截圖輸出檔案 (OSS Object)。 說明
樣本中{Count}是預留位置,圖片 Object 依次為 |
output{Count}.jpg |
| Location |
string |
截圖輸出 OSS Bucket 所在的 OSS Location。 |
oss-cn-shanghai |
| Bucket |
string |
截圖輸出檔案所在 OSS Bucket。 |
test-bucket-**** |
| VideoCensor |
string |
是否需要審核視頻內容。預設值:true。可取值:
|
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 |
視頻中的位置。格式: |
00:02:59.999 |
| Object |
string |
截圖輸出檔案 (OSS Object)。 說明
樣本中{Count}是預留位置,圖片 Object 依次為 |
output{Count}.jpg |
| CensorResults |
object |
||
| CensorResult |
array<object> |
包含多種類型審核結果的標籤、分值等。 |
|
|
object |
詳細資料。 |
||
| Suggestion |
string |
處理建議。取值:
|
block |
| Label |
string |
審核結果的標籤,多個使用半形逗號(,)分隔。
|
normal |
| Scene |
string |
審核情境。
|
porn |
| Rate |
string |
分值。可取值:0~100。 |
100 |
| NextPageToken |
string |
下一頁標識。 |
ea04afcca7cd4e80b9ece8fbb251 |
| CensorResults |
object |
||
| CensorResult |
array<object> |
審核結果集合,包含各種情境(黃、暴、恐、政)的概要資訊。 |
|
|
object |
審核結果詳細資料。 |
||
| Suggestion |
string |
處理建議。取值:
|
pass |
| Label |
string |
審核結果的標籤,多個使用半形逗號(,)分隔。
|
meaningless |
| Scene |
string |
審核情境。
|
ad |
| Rate |
string |
分值。可取值:0~100。 |
100 |
| PipelineId |
string |
管道 ID。 |
c5b30b7c0d0e4a0abde1d5f9e751**** |
| RequestId |
string |
請求 ID。 |
D1D5C080-8E2F-5030-8AB4-13092F17631B |
| NextPageToken |
string |
下一頁標識,32 位 UUID。查詢結果大於一頁時返回,每次查詢值都會更新。 |
9b1a42bc6e8d46e6a1383b7e7f01**** |
| NonExistIds |
object |
||
| String |
array |
不存在的作業 ID 列表。如果為空白則不返回此參數。 |
|
|
string |
作業 ID。 |
78dc866518b843259669df58ed30**** |
樣本
正常返回樣本
JSON格式
{
"MediaCensorJobList": {
"MediaCensorJob": [
{
"CreationTime": "2021-11-04T07:25:48Z\n",
"FinishTime": "2021-11-04T07:25:50Z\n",
"Suggestion": "pass",
"CoverImageCensorResults": {
"CoverImageCensorResult": [
{
"Object": "test/ai/censor/v2/vme-****.jpg\n",
"Location": "oss-cn-shanghai",
"Bucket": "example-Bucket-****\n",
"Results": {
"Result": [
{
"Suggestion": "pass",
"Label": "normal",
"Scene": "live",
"Rate": "100"
}
]
}
}
]
},
"State": "Success",
"TitleCensorResult": {
"Suggestion": "block",
"Label": "meaningless",
"Scene": "antispam",
"Rate": "100"
},
"Message": "The resource operated cannot be found",
"Input": {
"Object": "test/ai/censor/test-****.mp4",
"Location": "oss-cn-shanghai\n",
"Bucket": "bucket-test-in-****"
},
"BarrageCensorResult": {
"Suggestion": "pass",
"Label": "normal",
"Scene": "antispam",
"Rate": "99.91"
},
"DescCensorResult": {
"Suggestion": "pass",
"Label": "normal",
"Scene": "antispam",
"Rate": "100"
},
"VideoCensorConfig": {
"OutputFile": {
"Object": "output{Count}.jpg",
"Location": "oss-cn-shanghai\n",
"Bucket": "test-bucket-****\n"
},
"VideoCensor": "true",
"BizType": "common"
},
"JobId": "f8f166eea7a44e9bb0a4aecf9543",
"UserData": "example userdata ****\n",
"Code": "InvalidParameter.ResourceNotFound",
"VensorCensorResult": {
"VideoTimelines": {
"VideoTimeline": [
{
"Timestamp": "00:02:59.999",
"Object": "output{Count}.jpg",
"CensorResults": {
"CensorResult": [
{
"Suggestion": "block",
"Label": "normal",
"Scene": "porn",
"Rate": "100"
}
]
}
}
]
},
"NextPageToken": "ea04afcca7cd4e80b9ece8fbb251",
"CensorResults": {
"CensorResult": [
{
"Suggestion": "pass",
"Label": "meaningless",
"Scene": "ad",
"Rate": "100"
}
]
}
},
"PipelineId": "c5b30b7c0d0e4a0abde1d5f9e751****\n"
}
]
},
"RequestId": "D1D5C080-8E2F-5030-8AB4-13092F17631B\n",
"NextPageToken": "9b1a42bc6e8d46e6a1383b7e7f01****\n",
"NonExistIds": {
"String": [
"78dc866518b843259669df58ed30****\n"
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。