History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
GET /<ObjectKey>?ci-process=DetectFace&max-face-num=<FaceNum> HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>
参数名称 | 描述 | 类型 | 是否必选 |
ObjectKey | 对象文件名，例如：folder/document.jpg。 | String | 是 |
ci-process | 数据万象处理能力，人脸检测固定为 DetectFace。 | String | 是 |
max-face-num | 最多处理的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为120。此参数用于控制处理待检测图片中的人脸个数，值越小，处理速度越快。 | Integer | 否 |
<Response><ImageWidth>616</ImageWidth><ImageHeight>442</ImageHeight><FaceModelVersion>4.0</FaceModelVersion><RequestId>NjEzZjBlZGRfOTBmYTUwNjRfZWUx****</RequestId><FaceInfos><X>312</X><Y>-5</Y><Width>117</Width><Height>173</Height></FaceInfos></Response>
节点名称（关键字） | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器。 | Container |
节点名称（关键字） | 父节点 | 描述 | 类型 |
ImageWidth | Response | 请求的图片宽度。 | Integer |
ImageHeight | Response | 请求的图片高度。 | Integer |
FaceModelVersion | Response | 人脸识别所用的算法模型版本。 | String |
RequestId | Response | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 | String |
Status | Response | 识别情况，为1时表示识别到图片内有人脸，为0内表示未在图片内识别到人脸。 | String |
FaceInfos | Response | 人脸信息列表。包含人脸坐标信息。 | Container |
节点名称（关键字） | 父节点 | 描述 | 类型 |
Score | FaceInfos | 置信度。表示识别到的人脸置信度，范围0-100。 | Integer |
X | FaceInfos | 人脸框左上角横坐标。人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 | Integer |
Y | FaceInfos | 人脸框左上角纵坐标。人脸框包含人脸五官位置并在此基础上进行一定的扩展，若人脸框超出图片范围，会导致坐标负值。 | Integer |
Width | FaceInfos | 人脸框宽度。 | Integer |
Height | FaceInfos | 人脸框高度。 | Integer |
错误码 | 描述 |
FailedOperation.ConflictOperation | 操作冲突，请勿同时操作相同的 Person。 |
FailedOperation.GroupInDeletedState | 当前组正处于删除状态，请等待。 |
FailedOperation.GroupPersonMapExist | 组中已包含对应的人员 ID。 |
FailedOperation.GroupPersonMapNotExist | 组中不包含对应的人员 ID。 |
FailedOperation.ImageDecodeFailed | 图片解码失败。 |
FailedOperation.ImageDownloadError | 图片下载错误。 |
FailedOperation.ImageFacedetectFailed | 人脸检测失败。 |
FailedOperation.ImageResolutionExceed | 图片分辨率过大。 |
FailedOperation.ImageResolutionTooSmall | 图片短边分辨率小于64。 |
FailedOperation.ImageSizeExceed | base64编码后的图片数据大小不超过5MB。 |
FailedOperation.RequestLimitExceeded | 请求频率超过限制。 |
FailedOperation.RequestTimeout | 后端服务超时。 |
FailedOperation.ServerError | 算法服务异常，请重试。 |
InternalError | 内部错误。 |
InvalidParameter.InvalidParameter | 参数不合法。 |
InvalidParameterValue.AccountFaceNumExceed | 账号脸数量超出限制。 |
InvalidParameterValue.FaceModelVersionIllegal | 算法模型版本不合法。 |
InvalidParameterValue.ImageEmpty | 图片为空。 |
InvalidParameterValue.LimitExceed | 返回数量超出限制。 |
InvalidParameterValue.NoFaceInPhoto | 图片中没有人脸。 |
InvalidParameterValue.UrlIllegal | URL 格式不合法。 |
LimitExceeded.ErrorFaceNumExceed | 人脸个数超过限制。 |
MissingParameter.ErrorParameterEmpty | 必选参数为空。 |
ResourceUnavailable.Freeze | 账号已被冻结。 |
ResourceUnavailable.InArrears | 账号已欠费。 |
ResourceUnavailable.LowBalance | 余额不足。 |
ResourceUnavailable.StopUsing | 账号已停服。 |
ResourceUnavailable.UnknownStatus | 计费状态未知。 |
ResourcesSoldOut.ChargeStatusException | 计费状态异常。 |
UnsupportedOperation.UnknownMethod | 未知方法名。 |
GET /test.jpg?max-face-num=1&ci-process=detect-face HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 414641Date: Thu, 15 Jun 2017 12:37:29 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><ImageWidth>616</ImageWidth><ImageHeight>442</ImageHeight><FaceModelVersion>3.0</FaceModelVersion><RequestId>NjEzZjBlZGRfOTBmYTUwNjRfZWUxXzE=</RequestId><FaceInfos><X>312</X><Y>-5</Y><Width>117</Width><Height>173</Height></FaceInfos><FaceInfos><X>600</X><Y>-5</Y><Width>117</Width><Height>173</Height></FaceInfos></Response>
文档反馈