人脸识别

从自拍中派生出稳定的 person_id——身份是调用的输出，而非输入。用户无需声明任何标识符。

此用例解决的问题

人脸识别适用于不存在政府颁发文件关联的场景——即客户出于隐私原因不希望采集证件号码的情况。

其核心功能是通过单次自拍提交，为每张人脸创建唯一身份。

这使您能够：

• 检测回访用户并防止重复账号 — 识别同一人是否再次返回或尝试创建多个账号，无需官方证件即可实现一致的身份识别。
• 通过 Web、原生或 API 接入 — 仅以自拍图像为输入，无需任何额外的证件数据。
• 与其他信号组合使用 — 可根据需要将 IdFace 与其他能力叠加使用。

在以下情况下使用此用例：

• 您希望提供完全无摩擦的入职入口，无需输入任何内容，也无需上传文件。
• 您需要仅凭人脸识别回访用户，将其关联到您系统中以 person_id 为键的现有记录。
• 您的场景需要在无需先验上下文的情况下识别用户，例如自助终端、销售终端或首次接触的 B2B 合作伙伴流程。

如果您的场景已有声明的标识符，只需确认该人脸属于该用户，请改用无文件新用户注册。

涉及的能力

在单个流程中执行的流水线：

活体检测IdFace

能力	是否必需	在流程中的作用
活体检测	所有情况下推荐使用	确认采集时摄像头前有真实的人。流程的生物特征锚点。
IdFace	所有情况下必需	根据自拍在注册库中识别用户身份，并返回稳定的不透明 person_id。

提示

当需要额外的欺诈信号时，可将风险欺诈分类附加到基础流水线中。

前提条件

• Bearer token — 请参阅认证。
• 沙箱凭证 — 请参阅环境。
• 已安装 SDK 或 Web 组件 — 仅适用于 Web 和 SDK 集成。

分步实施

原生

通过原生 SDK 集成 — 采集在您的应用内运行，使用适用于 Android、iOS 或 Flutter 的 Unico SDK。

1. 安装 SDK — 为您的平台添加 Unico SDK 依赖项。请参阅 Android、iOS 或 Flutter 的安装指南。
2. 创建流程 — 调用创建流程，传入 flow=idface。使用返回的 token 初始化 SDK。
3. 启动采集 — SDK 渲染摄像头 UI 并在设备端执行活体检测，返回采集到的数据。
4. 查询结果 — 调用获取流程以获取 IdFace 结果。
5. 应用业务规则 — 根据 idFace.result 字段决定通过、拒绝或升级处理。

Android

用于应用内采集的原生 Android SDK。

查看概览

iOS

用于应用内采集的原生 iOS SDK。

查看概览

Flutter

用于应用内采集的跨平台 Flutter SDK。

查看概览

Web

通过 iFrame、重定向或原生集成 — Unico 托管采集 UI，您通过轮询接收结果。

1. 创建流程 — 调用创建流程，传入 flow=idface。响应中包含 userRedirectUrl。
2. 重定向用户 — 将用户引导至 userRedirectUrl。Unico 负责渲染采集流程。原生应用使用 webAppToken。
3. 用户完成流程 — 采集完成后，用户将被重定向回您的 callbackUri。
4. 查询结果 — 调用获取流程以获取 IdFace 结果。
5. 应用业务规则 — 根据 idFace.result 字段决定通过、拒绝或升级处理。

Web

通过浏览器快速集成，无需安装。

查看概览

API

直接 API 集成——使用 Unico SDK 或遵循采集标准采集自拍，然后将图像直接发送至 Unico API。

1. 采集自拍 — 使用适用于您平台的 Unico SDK，或遵循采集标准获取符合活体检测要求的自拍图像。
2. 创建流程 — 调用创建流程，传入 flow=idface, imagebase64 格式的自拍。
3. 查询结果 — 调用获取流程以获取 IdFace 结果。
4. 应用业务规则 — 根据 idFace.result 字段决定通过、拒绝或升级处理。

API

通过后端直连集成，完全掌控流程。

查看概览