---
title: Human Token
description: 从自拍中派生出稳定的、不透明的 humanToken——身份是调用的输出，而非输入。用户无需声明任何标识符。
canonical: https://developer.unico.io/zh-CN/human-token/
locale: zh-CN
generated_by: markdown-export
---

- [/zh-CN/](/zh-CN/)
- Human Token

**本页内容Human Token

只需一张人脸照片，即可将您的用户转化为一个独一无二的人。简单、直观且安全。
**一个人。一个 Token。始终如此。** Human Token 通过单张自拍为每张人脸创建唯一身份标识，无需政府颁发的证件。无论是在不存在这种关联的场景，还是在客户不愿共享证件号码的场景，都同样适用。需要时，随时发起新的验证并比较 Token：Token 相同即代表同一个人。
这使您能够：

**检测复访用户并防止重复账号**：一张人脸，一个 Token。无需官方证件，即可在注册、登录和账号找回环节识别重复或虚假账号。
**通过 Web、Native 或 API 集成**：仅以自拍图像作为输入，无需提供额外的证件数据。
**与其他信号结合使用**：根据需要，将 Human Token 与其他 capabilities 搭配使用。

最常见的场景包括深度伪造攻击（无需 CAPTCHA 和短信，即可确认每个操作背后都有一个真实且在场的人）、多账号、促销和推荐滥用、密码找回、新设备认证以及降低违约率。在决策之前评估风险，而不是在损失之后。
### 功能说明​

Human Token 根据采集到的自拍，生成一个稳定的、不透明的生物特征标识符（`humanToken`），用于唯一代表该人脸。用户无需声明任何标识符——身份是调用的输出，而非输入。每次匹配成功时，响应都会返回相同的 `humanToken`，使系统能够在后续流程中、在任何设备或会话上识别同一用户。
**Privacy by Design：** 无需任何预先数据，人脸照片可在处理后丢弃：保留在您系统中的是 Token，而不是人脸——从而显著降低贵公司及您客户的生物特征数据暴露风险。
### 输入​

唯一的输入是自拍。使用 API Only 流程时，您的后端以 `imageBase64` 形式在[创建流程](/zh-CN/human-token/api-reference/post-processes)的请求体中发送自拍。使用 Human Token Journey 流程（`humantoken` 或 `humantoken+revalidation`）时，自拍在旅程中采集。
需要 SDK 以保障采集质量为确保通过 API 发送的图像满足生物特征要求，请使用适用于您平台的 [Unico SDK](/zh-CN/human-token/integrations) 或遵循[采集标准](/zh-CN/human-token/additional-resources/capture-standard)。Human Token 不接受未经采集质量控制的任意图像。
### 可能的响应​

结果位于 `data.humanToken` 中：`value` 是标识符，`state` 表示流程所处的阶段——结果就绪时为 `PROCESS_STATE_FINISHED`。参见[创建流程 › 解读结果](/zh-CN/human-token/api-reference/post-processes#interpreting-the-result)。
无法生成 `humanToken` 的情况Human Token 仅在一种情况下不会生成 `humanToken`：无法在提交的图像中识别出人脸——未检测到人脸、图像质量过低，或人脸不符合采集标准（倾斜、侧向）。遵循[采集标准](/zh-CN/human-token/additional-resources/capture-standard)可避免这种情况。
`humanToken` 是一个稳定的、不透明的标识符——同一用户始终解析为相同的值。请将其存储在您的用户记录旁边，以便在后续 Human Token 调用中识别同一用户。
### API 集成​

Human Token 运行在 Human API 上。您的后端通过[创建流程](/zh-CN/human-token/api-reference/post-processes)创建流程：使用 API Only 流程（`api+humantoken`、`api+liveness+humantoken` 或 `api+liveness+humantoken+revalidation`）时，`humanToken` 会在同一响应中返回；使用 Human Token Journey 流程（`humantoken` 或 `humantoken+revalidation`）时，用户完成旅程后，您的后端通过[获取流程](/zh-CN/human-token/api-reference/get-process)获取结果。
开始使用：

设置[身份验证](/zh-CN/human-token/get-started/authentication)——每次调用都会在 `x-unico-accesskey` 请求头中发送您的访问密钥。
通过[创建流程](/zh-CN/human-token/api-reference/post-processes)创建流程，并读取 `data.humanToken`。
需要时，通过[获取流程](/zh-CN/human-token/api-reference/get-process)再次查询该流程。

### 可用性​

所需集成组件API Web最后更新 于 2026年10月21日**