智汇云-企业数智化核心引擎

# 图片审核
本文提供了调用图片审核具体接口和参数说明。温馨提示：调用此服务API需登录智汇云官网进行开通，https://zyun.360.cn/manage

### 接口名
/v1/verify/image
### 请求域名
ai.zyun.360.cn
### 通讯协议
支持通过HTTP协议进行请求通信
### 请求方式 
支持post方式发送请求

### 请求参数

#### Header头中传递的参数

|参数 |参数名 |参数描述|
| ------------ | ------------ | ------------ |
|Authorization |鉴权信息 |鉴权信息规则参见下方规则详细描述。|
|Auth-Time| 当前时间 |规则参见下方详细描述。|
|Rand-Num |随机数 |规则参见下方详细描述。|
|Auth-Ver |版本号 |固定值:1.0|

####header认证参数说明 
|参数名称 |说明| 用法|
| ------------ | ------------ |
|Authorization|认证字符串| 生成第一步：将AK、auth_time、rand_num、param_sign 拼接成一个字符串、中间用"\n"分隔。第二步：用SK对第一步生成的字符串做sha1加密，生成authorization |
|Auth-Ver|认证版本| 1.0 | 
|Auth-Time|认证时间| 表示此次操作的时间，unix系统时间戳（10位）(不能为空，如果请求中的Auth-Time时间和服务器的时间差15分钟以上，服务器将拒绝该服务，并返回ERROR错误) | 
|Rand-Num|随机正整数| 表示一个随机正整数(rand生成即可) |

##Authorization生成规则
```
$auth_time      = time();
$auth_string    = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign;
$encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true));
$authorization  = $ak . ":" . $encrypt_string;

```
###构造密码串
|参数说明 |参数名称 |说明| 用法|
| ------------ | ------------ |
|auth_time |unxi时间戳(10位)| |
|ak |Access Key| 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey | 
|sk |Secret Access Key| 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey| 
|rand_num |随机正整数| | 
|param_sign|参数按键排序并加入随机因子| 所有参数按key做升序排序后串成字符串$paramStr，然后 $paramStr的md5值连上$rand_num，然后再用md5计算得到的值为param_sign paramStr排序例子： 参数 { a1:v1, b1:v3, a2:v2 } 排序后的字符串为 a1=v1a2=v2b1=v3 |

#### body中传递的参数（post）

| 参数名称 | 必选 |类型 | 参数说明 |
| ------------ | ------------ | ------------ |
|image_id |false | string[0~64] | 图片标识,用户指定的图片标识(支持数字、字母、下划线、中划线、点) |
|template_id |true | string| 审核模板ID，在控制台中可以创建 |
| image_type | true | 枚举 | 图片类型：URL(图片url)、S3(云存储地址bucket/filename)、BASE64(图片内容base64) |
|image | true | string | 图片内容：根据image_type填写相应内容 |
|callback | false | string | 回调地址。当此参数不为空时，认定为异步任务。 |

### 返回结果说明

####同步返回结果说明

|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|errcode |true| int | 错误码 |
|errmsg |true | string| 错误描述 |
|data | true | json | 响应结构体 |

####data结构

|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|taskid |true| string | 任务ID |
|request_id |true |int| 请求时间 |
|cost | true | float | 耗时 |
|body | true |json | 图片审核结果 |

####body结构

|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|sid|true| string | 图片处理ID |
|image_id |true |string| 图片标识:用户传入 |
|image | true | string | 图片内容：用户传入 |
|suggest_summary | true |string| 建议。PASS:正常内容，建议放行、REVIEW:可疑内容，建议人工审核、REJECT：违规内容、建议直接拦截 |
|suggest_summary_desc | true |string| 建议描述 |
|suggest_business_model | false |string| 建议违法模型 |
|suggest_business_model_desc | false |string| 建议违法模型描述 |
|items |true |json| 模型审核结果 |

####items结构

|参数名称 | 必选 |类型| 参数说明  |
| ------------ | ------------ | ------------ |
|business_model|true| string | 模型type |
|suggest |true |string| 建议。PASS:正常内容，建议放行、REVIEW:可疑内容，建议人工审核、REJECT：违规内容、建议直接拦截|
|suggest_desc | true | string | 建议描述 |
|score | true |float| 置信度[0~1] |
|label| true |string| 审核结果标签：一级标签 |
|label_desc |true |string| 审核结果标签描述 |
|second_labels | false |[]json| 二级标签 |

####second_labels结构

|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|score|true|float | 置信度[0~1] |
|label|true |int| 二级标签 |
|label_desc| true | string |标签描述|

###同步响应示例

```
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "taskid": "TID_T_2019103120677734171086",
        "request_time": 1572504902,
        "cost": 0.08519913,
        "body": {
            "sid": "IMAGE_V_QH_20677734236622",
            "image_id": "333",
            "image": "http://rs-beijing.oss.yunpan.360.cn/Object.getFile/huguanglei-gongyou/c2VxaW5namlhbmNlMi5qcGVn",
            "suggest_summary": "REVIEW",
            "suggest_summary_desc": "可疑内容，建议人工审核",
            "suggest_business_model": "PORN",
            "suggest_business_model_desc": "图片涉黄",
            "items": [
                {
                    "business_model": "PORN",
                    "suggest": "REVIEW",
                    "suggest_desc": "可疑内容，建议人工审核",
                    "score": 0.53818,
                    "label": "vulgar",
                    "label_desc": "低俗",
                    "second_labels": [
                        {
                            "score": 0.53818,
                            "label": 10,
                            "label_desc": "非常性感"
                        }
                    ]
                }
            ]
        }
    }
```

###异步返回结果说明

###data结构

|参数名称| 必选 |类型| 参数说明|
| ------------ | ------------ | ------------ |
|taskid |true| string | 任务ID |

###异步响应示例

```

"errcode": 0,

"errmsg": "ok",

"data": {

"taskid": "TID_Y_2019103118689828610"

}

```
##一级标签说明

|模型| 模型类型 |标签| 标签说明|
| ------------ | ------------ | ------------ |
|色情|PORN| porn | 色情|
|色情|PORN| vulgar | 低俗|
|色情|PORN| normal | 正常|
|暴恐|VIOLENCE| violence | 暴恐|
|暴恐 |VIOLENCE|normal  | 正常|
|危险物品|DANGEROUSTHINGS| dangerousthings | 危险|
|危险物品|DANGEROUSTHINGS| normal | 正常|
|政治敏感 |VIOLENCE| politics | 政治敏感|
|政治敏感 |VIOLENCE| normal | 正常
|OCR |OCRNormal| normal | 正常|
|OCR |OCRPorn| porn  | 涉黄|
|OCR |OCRAD| AD  | 广告 |
|OCR |OCRViolence| violence   | 涉暴 |
|OCR |OCRPolitics| politics    | 涉政 |
|OCR |OCRInsulted| insulted     | 辱骂 |
|OCR |OCRWhitelist| whitelist      | 白名单 |
|OCR |OCRBlacklist| blacklist       |黑名单 |
|广告 |AD| normal       |广告模型-正常 |
|广告 |ADAD| ad       |广告模型-广告 |
|广告 |ADWaterMark| watermark        |广告模型-水印|
|广告 |ADQRCode| qrcode        |广告模型-二维码|
|广告 |ADBarCode| barcode         |广告模型-条形码|
|广告 |ADWhitelist| whitelist          |白名单|
|广告 |ADBlacklist| blacklist          |黑名单|

#图片审核结果纠错

### 接口名

/v1/verify/image_calibrate

### 请求域名

ai.zyun.360.cn

### 通讯协议

支持通过HTTP协议进行请求通信

### 请求方式

支持post方式发送请求

### 请求参数

#### Header头中传递的参数

| 参数          | 参数名   | 参数描述                       |
| ------------- | -------- | ------------------------------ |
| Authorization | 鉴权信息 | 鉴权信息规则参见鉴权详细描述。 |
| Auth-Time     | 当前时间 | 规则参见鉴权详细描述。         |
| Rand-Num      | 随机数   | 规则参见鉴权详细描述。         |
| Auth-Ver      | 版本号   | 固定值:1.0                     |

#### body中传递的参数（post）

| 参数名称    | 必选  | 类型   | 参数说明                                                     |
| ----------- | ----- | ------ | ------------------------------------------------------------ |
| template_id | true  | string | 图片审核模板ID，在控制台中可以创建                           |
| taskid      | true  | string | 图片审核任务唯一标识                                         |
| type        | true  | string | 纠错类型 error:误杀 miss漏杀                                 |
| labelId     | false | int    | 纠错类型为漏杀时必传  内容风险类型 1:涉政 2:色情 3:性感 4:广告 5:暴恐 6:违禁 7:商企logo 8:二维码 9:社交人脸 10:未成年人 11:公众人物 12:不良行为 13:辱骂 14:灌水 15:无意义 |
| riskLevel   | true  | string | 期望处置结果 PASS:通过 REJECT:违规                           |

### 请求示例

```
POST /v1/verify/image_calibrate HTTP/1.1
Auth-Ver: 1.0
Auth-Time: 1587974786
Rand-Num: 8888
Authorization:xxxxxxxxxxxxxxxxxxxx
User-Agent: PostmanRuntime/7.24.1
Accept: */*
Cache-Control: no-cache
Postman-Token: 14a15c58-c5fa-4712-90d4-24534b491232
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Type: multipart/form-data; boundary=--------------------------769354003527143578128173
Content-Length: 562
----------------------------769354003527143578128173
Content-Disposition: form-data; name="template_id"
158771917344392482224503
----------------------------769354003527143578128173
Content-Disposition: form-data; name="taskid"
TID_V_20220602297706882902327
----------------------------769354003527143578128173
Content-Disposition: form-data; name="type"
error
----------------------------769354003527143578128173
Content-Disposition: form-data; name="labelId"
1
----------------------------769354003527143578128173
Content-Disposition: form-data; name="riskLevel"
PASS
```

### 错误码说明
|错误码 |说明|
| ------------ | ------------ | 
|0 |正常|
|400001|未知错误|
|400002|系统内部错误|
|400003|签名错误|
|400004|参数错误|
|401000|任务队列满了|
|401001|任务执行超时|
|440001|图片地址不可用|
|440002|图片审核失败|
|440004|系统负载过高|
|440005|任务不存在|
|440006|任务处理中|
|440101|模板ID格式错误|
|440102|图片ID格式错误|
|440103|审核类型格式错误|
|440104|图片格式错误|
|440105|图片内容格式错误|
|440106|回调地址格式错误|

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

内容审核

产品说明

内容审核产品文档

服务开通操作手册

内容审核API文档

图片审核API（单张）

文本审核API（单条）

音频审核API

音频流审核API

视频审核API

视频流审核API

网页审核API

文档审核API

SDK示例

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费咨询智汇云专属顾问

为您量身定制产品解决方案