/liveness/liveness_image
该API功能为活体检测成功以后从视频中提取人脸图片。
该接口需要配合活体检测一起使用。
请求方式
GET
请求 URL
https://cloudapi.linkface.cn/liveness/liveness_image/{image_id}
备注：将 {image_id} 替换为真正的 image_id 参数
请求参数
| 请求参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| image_id | string | 是 | 活体图片 ID |
| api_id | string | 是 | API 账户 |
| api_secret | string | 是 | API 密钥 |
正常响应（200）
- 返回完整图片(二进制数据)
错误响应
| 状态码 | status 字段 |
说明 |
|---|---|---|
400 |
INVALID_ARGUMENT | 请求参数错误，具体原因见 reason 字段内容 |
401 |
UNAUTHORIZED | 账号或密钥错误 |
401 |
KEY_EXPIRED | 账号过期，具体情况见 reason 字段内容 |
403 |
RATE_LIMIT_EXCEEDED | 调用频率超出限额 |
403 |
OUT_OF_QUOTA | 调用次数超出限额 |
404 |
NOT_FOUND | 请求图片资源部存在 |
500 |
INTERNAL_ERROR | 服务器内部错误 |
错误返回样例
{
"status": "IMAGE_ID_NOT_EXIST",
"reason": "not exists",
"request_id": "TIDa892b593c0354b0e989b5db67a331607"
}
使用样例
curl 样例
curl -X GET "https://cloudapi.linkface.cn/liveness/liveness_image/{image_id}?api_id=ID&api_secret=SECRET"