人脸检测

在照片中找出人脸，返回每张脸的边界框、置信度分数，以及以 Base64 裁剪出的人脸图像。

POST/v3/store/ekyc/face-detection/single

另有 1 个端点

试一试

价格0.2 IC每次请求
累计调用553.9K次

输入

输出POST /v3/store/ekyc/face-detection/single

bbox: xmax: 320.15 xmin: 100.23 ymax: 450.78 ymin: 150.45
detection_score: 0.9998989105224609
face: /9j/4AAQ...base64_encoded_image
message: success
process_time: 0.41

全部字段见“响应”一节其他端点：/multi 见请求

请求

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-detection/single \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@photo.jpg"

响应

200成功。字段在"响应"一节说明。

{
    "bbox": {
        "xmax": 320.15,
        "xmin": 100.23,
        "ymax": 450.78,
        "ymin": 150.45
    },
    "detection_score": 0.9998989105224609,
    "face": "/9j/4AAQ...base64_encoded_image",
    "message": "success",
    "process_time": 0.41
}

请求

multipart/form-data，每次一张图像。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

照片。JPEG 或 PNG，最大 10 MB。

端点	返回	价格
`/v3/store/ekyc/face-detection/single`	最显著的一张脸	每次请求 0.2 IC
`/v3/store/ekyc/face-detection/multi`	全部人脸，最多 50 张，位于 `result[]`	每次请求 0.3 IC

旧路径 /face_detect_single 与 /face_detect_multi 仍可用，价格相同。

响应

详情

实测

指标	结果
耗时，单张脸	0.3 至 0.5 秒
耗时，多张脸	0.5 至 1.0 秒

限制

每张图像最多 50 张脸。
分辨率低、光线或对焦不佳、头部姿态和遮挡会降低 detection_score；使用结果前请先检查该值。

数据处理

图像在内存中处理，响应返回后不保留。服务符合 GDPR 与 PDPA。

更新日志

版本	日期	变更
1.0	2023 年 1 月	首次发布。

请求​

响应​

详情​

请求

响应

详情