创建审核媒资任务 - CreateAssetReviewTask
功能介绍
对上传的媒资进行审核。审核后,可以调用查询媒资详细信息接口查看审核结果。
接口约束
目前仅“华北-北京一”、“华北-北京四”区域的点播服务支持此功能。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1.0/{project_id}/asset/review
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID,获取方法请参考获取项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
否 |
String |
用户Token,使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
Authorization |
否 |
String |
使用AK/SK方式认证时必选,携带的鉴权信息。 |
|
X-Sdk-Date |
否 |
String |
使用AK/SK方式认证时必选,请求的发生时间。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
asset_id |
是 |
String |
VOD分配的媒资ID,仅支持查询,不支持修改。 |
|
review |
是 |
Review object |
媒资审核参数。
说明:
仅“华北-北京一”、“华北-北京四”点播服务支持此功能。
|
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
template_id |
否 |
String |
审核模板ID。您可以在视频点播控制台配置审核模板后获取,具体请参见《点播服务用户指南》中的“审核设置”。
说明:
仅“华北-北京一”、“华北-北京四”点播服务支持此功能。
|
|
interval |
否 |
Integer |
截图检测时间间隔,取值范围为(0,100],该参数在请求参数中忽略。 |
|
politics |
否 |
Integer |
鉴政内容检测置信度,取值范围为-1或者[0,100],该参数在请求参数中忽略。 置信度越高,说明审核结果越可信。未开启或设置为0时,表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 |
|
terrorism |
否 |
Integer |
鉴恐内容的检测置信度,取值范围为-1或者[0,100],该参数在请求参数中忽略。 置信度越高,说明审核结果越可信。未开启或设置为0时,表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 |
|
porn |
否 |
Integer |
鉴黄内容的检测置信度,取值范围为-1或者[0,100],该参数在请求参数中忽略。 置信度越高,说明审核结果越可信。未开启或设置为0时,表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
asset_id |
String |
VOD分配的媒资ID,仅支持查询,不支持修改。 |
|
review |
Review object |
媒资审核参数。
说明:
仅“华北-北京一”、“华北-北京四”点播服务支持此功能。
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
template_id |
String |
审核模板ID。您可以在视频点播控制台配置审核模板后获取,具体请参见《点播服务用户指南》中的“审核设置”。
说明:
仅“华北-北京一”、“华北-北京四”点播服务支持此功能。
|
|
interval |
Integer |
截图检测时间间隔,取值范围为(0,100],该参数在请求参数中忽略。 |
|
politics |
Integer |
鉴政内容检测置信度,取值范围为-1或者[0,100],该参数在请求参数中忽略。 置信度越高,说明审核结果越可信。未开启或设置为0时,表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 |
|
terrorism |
Integer |
鉴恐内容的检测置信度,取值范围为-1或者[0,100],该参数在请求参数中忽略。 置信度越高,说明审核结果越可信。未开启或设置为0时,表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 |
|
porn |
Integer |
鉴黄内容的检测置信度,取值范围为-1或者[0,100],该参数在请求参数中忽略。 置信度越高,说明审核结果越可信。未开启或设置为0时,表示未进行此项检测。politics、terrorism、porn三个参数不能同时为0。 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误描述。 |
请求示例
审核上传的媒资
POST https://{endpoint}/v1.0/{project_id}/asset/review
Content-Type: application/json
{
"asset_id": "3e1cd21131a94525be55acf65888bf46",
"review": {
"template_id": "c80e56dadb8542e8a1b7c2224dd6733a"
}
}
响应示例
状态码:200
处理成功返回。
{
"asset_id" : "ede1391f8be15b4bcf99099c8d437c00",
"review" : {
"template_id" : "c80e56dadb8542e8a1b7c2224dd6733a",
"interval" : 5,
"politics" : 0,
"terrorism" : 0,
"porn" : 1
}
}
状态码:400
处理失败返回。
{
"error_code" : "VOD.10062",
"error_msg" : "Media asset or resource does not exist, please check."
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
处理成功返回。 |
|
400 |
处理失败返回。 |
错误码
请参见错误码。