最近更新时间：2021-03-12
本节以明星人物识别为例，识别一张明星人物图片。通过Token认证方式调用明星人物识别的API请求。
调用地址：https://apim.unicloud.com/api/image/star/1.0.0/
请求方式：POST
返回类型：JSON
Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer |
Body如下：
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | true | string or file | -- | 1、支持传图片URL或者直接post图片文件，不过两者不能混在同一请求中 2、只支持对静态图像的处理，如：png、jpg、jpeg、tif、webp，不支持动态图像的处理，如：gif 3、图片大小必须在1M以内，且建议对图片进行压缩处理，等比压缩到[256, 512]之间 |
注：Body使用form-data形式
curl -k -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" \ -F 'image=@image_or_url' \ https://apim.unicloud.com/api/image/star/1.0.0/
curl -k -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" \ -F 'image=@image_or_url' \ https://apim.unicloud.com/api/image/star/1.0.0/
curl -k -H "Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3" -F 'image=@image_or_url' https://apim.unicloud.com/api/image/star/1.0.0/
注：发送请求时，Token请填写上面“步骤2：创建应用”后得到的Token。
| 字段 | 类型 | 说明 |
|---|---|---|
| data | object | 返回结果数据 |
| +objects | array | 检测出来的所有人脸 |
| ++facePosition | array | 检测到的人脸坐标信息 [左上角坐标，右上角坐标，右下角坐标，左下角坐标] |
| ++label | int | 搜索结果 -1：识别失败 0：明星人物 2：非明星人物 3：无人脸 |
| ++similarity | float | 与人物的相似度，范围在[0-1]之间，分值越高，越相似 |
| ++faceId | string | 最终给出相似人物的名字 |
| ++typeName | string | 最相似人物的所属类型名称 |
| code | int | 返回码 |
| message | string | 返回信息 |
{
"data": {
"objects": [
{
"facePosition": [
[
0.803858166649228,
0.039300969171903496
],
[
0.9261224837530226,
0.039300969171903496
],
[
0.9261224837530226,
0.14569213219599636
],
[
0.803858166649228,
0.14569213219599636
]
],
"similarity": 0.91219645738601685,
"typeName": "xxx",
"faceId": "YYY",
"label": 0
}
]
},
"code": 0,
"message": "success"
}请求方式：POST
Body选择form-data格式，并配置image，选择一个明星人物图片
Headers配置Content-Type：application/json 和 Authorization: Bearer Token值
