产品动态
产品公告
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>
文档反馈