注意：
接口描述
接口请求域名：https://recognition.image.myqcloud.com/face/compare
本接口（compare）用于计算两个 Face 的相似性以及五官相似度。
说明：
- 本接口支持 HTTPS 协议，如果您现在使用的是 HTTP 协议，为了保障您的数据安全，请切换至 HTTPS。
请求包 header
| 参数名 | 必选 | 值 | 描述 |
|---|---|---|---|
| host | 是 | recognition.image.myqcloud.com | 腾讯云人脸识别服务器域名。 |
| content-length | 否 | 包体总长度 | 整个请求包体内容的总长度，单位：字节（Byte）。 |
| content-type | 是 | application/json 或 multipart/form-data | 根据不同接口选择： 1. 使用 application/json 格式，参数为 url，其值为图片的 url。 2. 使用 multipart/form-data 格式，参数为 image，其值为图片的二进制内容。 |
| authorization | 是 | 鉴权签名 | 多次有效签名，用于鉴权，生成方式见 鉴权签名方法。 |
注意：选择 multipart/form-data 时，请使用 HTTP 框架/库推荐的方式设置请求的 content-type。如果直接调用 setHeader 等方法设置，可能会导致 boundary 缺失引起请求失败。
输入参数
使用 application/json 格式，参数选择 url ；使用 multipart/form-data 格式，参数选择 image。
| 参数名 | 必选 | 类型 | 参数说明 |
|---|---|---|---|
| appid | 是 | String | 接入项目的唯一标识，可在 账号信息 或 云 API 密钥 中查看。 |
| imageA | 否 | Binary | A 图片内容。 |
| imageB | 否 | Binary | B 图片内容。 |
| urlA | 否 | String | A 图片的 url，image 和 url 只需提供一个；如果都提供，只使用 url。 |
| urlB | 否 | String | B 图片的 url，image 和 url 只需提供一个；如果都提供，只使用 url。 |
输出参数
| 字段 | 类型 | 说明 |
|---|---|---|
| data.session_id | String | 相应请求的 session 标识符。 |
| data.similarity | Float | 两个 face 的相似度。 |
| data.fail_flag | Int | 标志失败图片，1 为第一张，2 为第二张（失败时返回）。 |
| code | Int | 返回码。 |
| message | String | 返回错误消息。 |
示例
输入示例
使用 url
POST /face/compare HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com
Content-Length: 123
Content-Type: application/json
{
"appid":"123456",
"urlA":"http://test-123456.image.myqcloud.com/testA.jpg",
"urlB":"http://test-123456.image.myqcloud.com/testB.jpg"
}使用 image
POST /face/compare HTTP/1.1
Authorization: FCHXdPTEwMDAwMzc5Jms9QUtJRGVRZDBrRU1yM2J4ZjhRckJi==
Host: recognition.image.myqcloud.com
Content-Length: 460
Content-Type: multipart/form-data;boundary=--------------acebdf13572468
----------------acebdf13572468
Content-Disposition: form-data; name="appid";
123456
----------------acebdf13572468
Content-Disposition: form-data; name="imageA"; filename="testA.jpg"
Content-Type: image/jpeg
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468
Content-Disposition: form-data; name="imageB"; filename="testB.jpg"
Content-Type: image/jpeg
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
----------------acebdf13572468--输出示例
HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 109
Content-Type: application/json
{
"data":{
"similarity":100.0,
"session_id":""
},
"code":0,
"message":"OK"
}错误码
| 错误码 | 含义 |
|---|---|
| 3 | 错误的请求；其中 message:account abnormal,errorno is:2 为账号欠费停服 |
| 4 | 签名为空 |
| 5 | 签名串错误 |
| 6 | 签名中的 APPID /存储桶与操作目标不匹配 |
| 9 | 签名过期 |
| 10 | APPID 不存在 |
| 11 | SecretId 不存在 |
| 12 | APPID 和 SecretId 不匹配 |
| 13 | 重放攻击 |
| 14 | 签名校验失败 |
| 15 | 操作太频繁，触发频控 |
| 16 | 存储桶不存在 |
| 21 | 无效参数 |
| 23 | 请求包体过大 |
| 24 | 本接口即将下线，请使用 新版人脸识别 |
| 107 | 鉴权服务不可用 |
| 108 | 鉴权服务不可用 |
| 213 | 内部错误 |
| -1101 | 人脸检测失败 |
| -1102 | 图片解码失败 |
| -1103 | 特征处理失败 |
| -1104 | 提取轮廓错误 |
| -1105 | 提取性别错误 |
| -1106 | 提取表情错误 |
| -1107 | 提取年龄错误 |
| -1108 | 提取姿态错误 |
| -1109 | 提取眼镜错误 |
| -1200 | 特征存储错误 |
| -1300 | 图片为空 |
| -1301 | 参数为空 |
| -1302 | 个体已存在 |
| -1303 | 个体不存在 |
| -1304 | 参数过长 |
| -1305 | 人脸不存在 |
| -1306 | 组不存在 |
| -1307 | 组列表不存在 |
| -1308 | url 图片下载失败 |
| -1309 | 人脸个数超过限制 |
| -1310 | 个体个数超过限制 |
| -1311 | 组个数超过限制 |
| -1312 | 对个体添加了几乎相同的人脸 |
| -1313 | 参数不合法（特殊字符例如空格、斜线、tab、换行符） |
| -1400 | 非法的图片格式 |
| -1403 | 图片下载失败 |
更多其他 API 错误码请查看 错误码说明 。
