任务提交
功能介绍
提交异步批量图像内容审核任务，返回任务标识，任务标识可用于查询任务结果。此接口为异步接口，相对于批量图像内容审核接口，支持更大图片列表批次。
URI
POST /v2/{project_id}/moderation/image/batch/jobs
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
urls |
是 |
Array of strings |
图片的URL路径，目前支持：
说明：
图片的URL路径列表最多支持500个URL地址。接口响应时间依赖图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 |
|
categories |
否 |
Array of strings |
检测场景。
可通过配置上述场景，来完成对应场景元素的检测。 |
|
moderation_rule |
否 |
String |
图像审核规则名称，默认使用default规则。
说明：
审核规则的创建和使用请参见配置审核规则。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
result object |
调用成功时表示调用结果。 调用失败时无此字段。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
|
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
|
fail_category |
String |
当包含多个场景时，调用失败的场景。 |
请求示例
提交异步批量图像内容审核任务，检测场景为涉黄。
POST https://{endpoint}/v2/{project_id}/moderation/image/batch/jobs
{
"urls" : [ "https://bucketname.obs.myhwclouds.com/ObjectName1", "https://bucketname.obs.myhwclouds.com/ObjectName2" ],
"categories" : [ "porn" ]
}
响应示例
状态码： 200
成功响应示例
{
"result" : {
"job_id" : "44d93b70-db01-4f96-a618-2a79c964c4b2"
}
}
状态码： 400
失败响应示例
{
"error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
成功响应示例。 |
|
400 |
失败响应示例。 |
错误码
请参见错误码。
