一次调用一个结论
传姓名、证件号、人脸图的公网地址，直接回「同一人 / 不是同一人」和分值。
按次计费
单价在后台改，改完立刻生效。次数包和余额两条线，调用记录里写明这一笔扣的哪一种。
失败不收费
上游系统异常那一类（没拿到结论），这次扣的次数或余额当场退回。
怎么接进去
三步，不用等审核，注册完就能调。
1
注册拿密钥
注册只要一个 QQ 号收验证码。密钥在控制台里建，一对两个值，建完只显示一次。
2
拉起一单
带上姓名、证件号。手上已有公网可打开的人脸图就再带一个图片地址，没有就让用户去手机上做一遍活体采集。
3
拿单号问结论
隔几秒问一次，拿到 2001 通过 / 2002 不是同一人 就结束。查询不扣费，问多少遍都一样。
两段调用长这样
图片自己有就把它一次给全（api/face.php），要用户现场采集就用下面这两个。
① POST https://face.yunsapi.com/api/face_start
X-Api-Id: AK3F9C1D2E4B5A60
X-Api-Key: 你的密钥
name=张三&idcard=340322199001011234&file_url=https://example.com/face.jpg
{
"code": 1001,
"msg": "让用户去做人脸采集，做完之后拿 check_id 来查。",
"data": { "check_id": "K20261007A1B2C3", "state": 1001, "live_url": "https://活体服务给的那条地址" }
}
② POST https://face.yunsapi.com/api/face_query
X-Api-Id: AK3F9C1D2E4B5A60
X-Api-Key: 你的密钥
check_id=K20261007A1B2C3
{
"code": 2001,
"msg": "核验通过。",
"data": { "check_id": "K20261007A1B2C3", "state": 2001, "passed": true, "score": 92.4 }
}
完整参数、返回码、错误处理见 接口文档。
次数包
买了就进次数，调用时先扣次数。次数用完也可以直接充值余额，两种都行。
常见问题
人脸图要传到哪里
我们只收一个公网能打开的图片地址，图不用传给我们。你自己的图床、对象存储都行。
怎么知道这次扣了钱
每次调用在「核验记录」里一条，写着这次扣的是次数还是余额、多少。失败退的也在里面。
要自己实名吗
要。核验类是敏感能力，调用方必须先过一遍实名。在控制台里做，一次就够。
没有现成的人脸图怎么办
让用户在自己手机上扫一遍活体采集，采到的脸直接进比对，你不用准备图片。