如何用 Toden 比较两张脸

Charles Archibong, 联合创始人

2026年10月4日

当您需要进行 1:1 的相似度判定时，请比较两张面部照片。此项检查独立于活体检测和客户档案搜索。

要点

沙盒匹配、审核、不匹配和无结果的情况分别处理。
必须获得同意并遵守照片尺寸要求。
该应用程序会存储并重新读取支票 ID。
模拟判决结果绝不会作为实时引擎结果呈现。

当您需要进行 1:1 的相似度判定时，请比较两张面部照片。此项检查独立于活体检测和客户档案搜索。

开始之前

两张清晰的面部照片
获得许可和同意后方可比较照片

请使用具有此控制权限的团队成员。更改设置前，请检查组织和环境。付款或持续注册前，请审核当前价格。屏幕截图显示的是示例工作区或公共集成参考；它们不显示真实客户或已完成的付款。

设置并使用该功能

步骤 1：打开面部匹配并选择环境

在控制面板中，打开“验证”→“抽查”→“人脸匹配” 。首次测试请选择“沙盒”。确认您的组织可以使用“抽查”功能，并且您的角色拥有运行比对的权限。独立版 API 使用相同的引擎和判例历史记录。沙盒返回模拟结果；它无法证明真实照片匹配的准确性。

Integration reference: Sandbox behaviour

集成参考：沙箱行为

步骤二：准备两张不同的、清晰的照片

使用两张已获得同意的照片，每张照片中都要有清晰可辨的人脸。 JPEG ， PNG 支持 WebP 格式。请勿重复发送同一张照片。请将每张照片分别上传到人脸匹配表单的不同部分，并确认已获得授权。请查看显示的组织阈值，而不是期望单个请求的阈值能够覆盖已记录的策略。

集成参考：比较

步骤 3：检查阈值并运行比较

在运行付费生产版比对之前，请先检查贵组织的匹配阈值和审核底线。运行一次双图比对并保存其比对 ID。匹配结果是指引擎在设定的阈值下对相似度的判断；这并不证明该人仍然在世或拥有账户。如果需要人工审核，请比较照片并单独记录您的策略决定。

整合参考：结论

步骤 4：在后端集成相同的比较功能

称呼 POST使用密钥和同意（true）通过 /api/kyc/face/compare 进行身份验证。请为每一方提供一个照片来源：imageA或mediaAId ，以及imageB或mediaBId 。图像可以是受支持的公共图像。 URL ，数据 URI 或 base64 编码。对于可重复使用的文件，请通过以下方式上传： POST 使用 /api/kyc/face/upload并传递媒体 ID。生物特征输入和密钥保存在服务器端。

Integration reference: Uploading first (optional)

集成参考：先上传（可选）

第五步：处理所有四项判决

请阅读faceCheck.verdict 、置信度以及该检查记录的阈值。匹配结果等于或高于及格线；审核结果介于及格线和最低线之间；不匹配结果低于最低线。无结果表示无法生成比对结果，且不收取任何费用。请勿将审核结果或服务失败归类为匹配结果。即使已完成不匹配比对，仍可能产生费用。

整合参考：结论

步骤 6：利用历史记录进行核对和审核

将检查 ID 与预期的应用程序操作关联起来。检索 GET在响应丢失或查看过往比对结果时，可以使用 /api/kyc/face/checks/{id}访问历史记录端点。该端点按结果和日期进行筛选并识别。API 主动发起的检查。重新查看已有结果与再次进行比较不同；不要盲目地重复付费检查以查找先前的结果。