---
title: 多账号
description: 在运营商库中执行 1:N 生物特征搜索，以检测某张面孔是否已与另一个活跃账号关联。
canonical: https://developer.unico.io/zh-CN/dual-api/capabilities/multi-accounts
locale: zh-CN
generated_by: markdown-export
---

多账号关注的是"该人脸是否已存在于运营商库的其他位置？"。

:::info[属于欺诈风险分类]
多账号是[欺诈风险分类](/capabilities/fraud-risk-classification)产品的一项能力。它不是单独签约的：而是在与 Unico 进行入职对接期间在您的 API Key 配置中启用。
:::

### 功能说明

在运营商库中执行分段式 1:N 生物特征搜索，将接收到的人脸与同一 `clientReferenceSegment` 下的所有记录进行交叉比对。检测该生物特征是否已与不同的 `clientReference` 绑定——表明同一人已创建或正尝试在同一运营商处创建多个账号。

### 输入项

- 用户的自拍照——在 API 集成中，您以 `imageBase64` 发送（PNG、JPEG 或 WebP；最小 640×480；最大 800 KB）；在 Web 集成中，采集由 Unico 执行。
- `clientReference`（API 中为 `subject.clientReference`）——**必填**。运营商系统中用户的唯一标识符：在您的库中唯一，最多 256 个字符，不含空格。

### 可能的响应

| 响应 | 含义 |
|---|---|
| `reproved` | 检测到多账号。该人脸生物特征已在同一分段内与不同的 `clientReference` 关联。 |
| `inconclusive` | 未检测到多账号。该人脸未在运营商库中的任何其他账号下注册。 |

此表代表该能力的单独响应。

:::warning[没有 `YES` 或 `NO` 响应]
多账号**不返回 `YES` 或 `NO`**——不存在重复的情况以 `inconclusive` 表示，而非确认永不存在风险。
:::

### 可用性

| 接入面 | 支持 |
|---|:-:|
| **SDK**（Android、iOS、Flutter）| ✅ |
| **Web**（iFrame、Redirect）| ✅ |
| **API**（无头，无 SDK）| ✅ |

在所有接入面上，该能力都要求在请求中提供用户的 `clientReference`，并在您的 API Key 中启用。

:::tip[API 枚举值]
在 Web 和 Native 合约响应中，多账号结果通过 `authenticationInfo.accountFarmingResult` 字段返回：检测到多账号时为 `TRUST_RESULT_YES`，未发现重复时为 `TRUST_RESULT_NO` / `TRUST_RESULT_INCONCLUSIVE`。这是一个专用字段——它不与 `authenticationInfo.identityFraudstersResult` 合并，后者对应的是另一项欺诈风险分类评估。
:::

:::warning[API 集成：活体检测]
在 API 集成中，活体检测是可选的。如果您发送未经活体检测的图像，1:N 搜索将基于未经验证的采集（例如翻拍照片）运行，结果也会继承该风险。我们建议在同一流程中启用活体检测，或遵循[采集标准](/developers/sdks-and-tools/capture-standard)使用 Unico SDK 进行采集。
:::

### 搜索范围

搜索范围由 `clientReferenceSegment` 字段控制，该字段由 Unico 在入职对接期间在您的 API Key 中配置——它不是您在请求中发送的字段。不同分段可在同一运营商内共存而不触发误报（适用于 B2B 子客户或同时有个人账户和企业账户的模式）；如果您的业务需要对搜索进行分段，请与您的 Unico 联系人讨论。

### 使用此能力的产品

- [多账号](/products/sign-up/multi-accounts)