跳到主要内容

图片

向我们的人脸识别 API 发送人脸照片是必须的。为了确保执行分析的更高可靠性，客户在拍照时需要遵守以下规则：

  • 照片中只能有一张人脸；
  • 整个人脸必须在照片中可见；
  • 人脸必须至少占照片面积的 15%；
  • 人脸必须正对相机并与相机平行；
  • 人脸眼睛必须睁开；
  • 人脸嘴巴必须闭合；
  • 人脸必须保持中性表情，不得微笑；
  • 人脸不得被任何类型的配件（帽子、眼镜或面具）遮挡。

此外，只接受最大 3MB 的 .jpeg 和 .png 图片。

文件发送​

Request Body
{
    "image": "base64_image_code"
}
Response Body
{ 
    "image_key": "f4b5337a-7b50-406e-8c8e-7d0e77b5aa02",
    "file_size": 47407,
    "width_px": 0,
    "height_px": 0,
    "created_at": "2020-07-29T18:40:57Z"
}

在需要发送图片而不立即执行注册或人脸验证流程的情况下，应发送包含图片 Base64 的 JSON 对象。 为此，需要向以下端点发送 POST 类型的请求：

https://api.caas.qitech.app/face_recognition/image

发送后，图片将进行质量测试，如果通过，将返回包含图片访问密钥的 JSON。此密钥应在人脸注册或验证期间用于引用该照片。

注意

只应发送与图片对应的 Base64 代码。

图片质量验证​

Response Body：无效图片情况
{
    "title": "image_quality",
    "description": "This image was not approved in quality assessment. The face is too close to image edges.",
    "image_status": "not_center"
}

在图片端点发送 POST 请求时，如果图片不足以进行验证，将返回 HTTP Status Code 400。

description 字段的值是解释图片无效原因的消息。

此外，我们返回一个 image_status 枚举器以映射图片无效的原因。以下是可能的 image_status 列表：

image_status描述
no_faces未识别到人脸。
multiple_faces识别到多张人脸。
close_face人脸离相机太近。
distant_face人脸离相机太远。
not_centered人脸未充分居中。
inclined_face人脸倾斜。
wearing_acessories人员正在使用遮挡部分脸部的配件。
facial_expression人员嘴巴张开、在微笑或闭着眼睛。
brightness_problem图片光照不足。
sharpness_problem图片不够清晰。

注意 - 还有其他原因会导致我们返回 400（均与无效数据相关）。只有 title 为 "image_quality" 的返回才是图片质量验证的结果，因此才应转达给用户。

文件检索​

图片检索

    curl "https://api.caas.qitech.app/face_recognition/image/f4b5337a-7b50-406e-8c8e-7d0e77b5aa02/file" \
         -H "Authorization: EXAMPLE_API_KEY"

随时可以检索已发送的图片。只需在端点发送经过适当认证的 GET 请求：

https://api.caas.qitech.app/face_recognition/image/{image_key}/file

其中 image_key 是在发送图片时返回的值。

检索已处理文件​

检索已处理图片

    curl "https://api.caas.qitech.app/face_recognition/image/f4b5337a-7b50-406e-8c8e-7d0e77b5aa02/cropped_file" \
         -H "Authorization: EXAMPLE_API_KEY"

将图片与注册或验证关联后，该图片将被处理，并生成一张仅包含用于人脸识别流程的面部的新图片。

此图片可通过在以下端点发送经过适当认证的 GET 请求来检索：

https://api.caas.qitech.app/face_recognition/image/{image_key}/cropped_file

其中 image_key 是在发送基础图片时返回的值。

检索文件元数据​

检索元数据

    curl "https://api.caas.qitech.app/face_recognition/image/f4b5337a-7b50-406e-8c8e-7d0e77b5aa02" \
         -H "Authorization: EXAMPLE_API_KEY"

将图片发送到 API 后，可以使用以下端点检索图片的元数据：

https://api.caas.qitech.app/face_recognition/image/{image_key}

其中 image_key 是在发送图片时返回的值。