稳定、快速的API服务

人脸比对，我们致力于为用户提供专业的免费API数据接口服务

人脸比对 v1.0

最后更新: 2026-09-02 12:12:08

人脸比对接口基于计算机视觉和深度学习技术，对输入的两张人脸照片进行分析，判断是否来自同一个人

按次计费(¥0.04/次) 调用次数: 0 正常运行 响应速度: <100ms 需要传入API密钥

接口信息

接口地址：
https://api.shuliancloud.com/v2/face_compare/check
请求方式： POST
返回格式： JSON

调用统计

0
今日调用
0
总调用次数
请求示例 https://api.shuliancloud.com/v2/face_compare/check

点击右侧按钮复制完整请求地址，参数值请替换为实际有效值

请求参数 （暂无请求参数）

参数名 是否必填 参数类型 参数说明
暂无请求参数信息

请求参数说明

|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名，<a href='#sign'>签名算法说明</a>  |
| firstImage  |varchar| 否 |第一张图片base64字符串|
| secondImage | varchar | 否 |第二张图片base64字符串|
| firstUrl | varchar | 否 |第一张图片url|
| secondUrl | varchar | 否|第二张图片url|

image、url二选一

返回参数 （暂无返回参数）

参数名 参数类型 参数说明
暂无返回参数信息

返回参数说明

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码  |   
| code  |成功为200，code=200收费  | 
| msg  | code对应的说明描述   | 
| data  | 验证结果详细信息|  
| order_no  | 订单号|
| score  | 比较结果分值，值为 0~1，值越大表示两张照片是同一个人的可能性越大

注意：当图片中存在多个人脸时，系统会选出其中最大的人脸进行比对

#### 比较结果阈值和错误率对照
|  阈值 | 0.4  |  0.5| 0.6 | 0.7 | 0.8 | 0.9
| ------| ----- | ------|-----|------|------|----|
|错误率|十分之一	|百分之一	|千分之一 |万分之一	|十万分之一	|百万分之一

返回示例 

{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "order_no": "608596343467937792",
        "score": 0.9891853928565979
    }
}