人脸识别

快速入门¶

又拍云处理（人脸识别）基于 CDN 或云存储服务，您在使用它之前，请确保您已经注册又拍云账号并完成实名验证，请确保您已经创建 CDN 服务或云存储服务。

收费方面，现在免费公测中，后续会进行收费。

---

开发者指南¶

请求方法¶

通过 URL 访问图片时，对图片进行识别。任务以同步的方式处理，处理完成后，响应信息中返回人脸识别的信息。

格式

图片 URL + 间隔标识符 + 参数

间隔标识符说明，见间隔标识符；参数说明，见功能。

举例

图片 URL 是 https://p.upyun.com/docs/cloud/face.jpg

人脸检测的 URL 是 https://p.upyun.com/docs/cloud/face.jpg!/face/detection

响应信息¶

• 识别成功：返回 200，响应信息是人脸识别结果。响应信息为 JSON 格式，字段名及含义如下：

参数	类型	说明
face	list	人脸位置坐标信息，如果没有人脸，返回空信息
size	list	图片的宽、高

举例

{
    "size": [
        598,
        960
    ],
    "face": [
        {
            "x": 179,
            "y": 290,
            "width": 288,
            "height": 288
        }
    ]
}

• 识别失败：返回相应的出错信息，具体请参阅「状态码表」。

---

状态码表¶

状态码	说明
200	处理成功
404	文件不存在
413	文件大小超出限制
415	不支持的文件类型
5xx	服务端错误。如遇此类错误，请反馈给售后或您的商务经理

---

功能¶

人脸检测¶

参数	值	说明
/face/<固定值>	detection	分析图片上是否有人脸，并返回相应信息

注

• 图片大小不能超过 8M，否则不处理。

---

如有疑问请 联系我们