头像解析：从图片或标识符获取个人资料属性

关于联系人数据头像解析的支柱指南：首先进行图片人像解析，其次是基于标识符的公开头像检查，最后是批量文件处理，并明确了结果含义的界限。

在业务联系人数据领域，头像解析是指分析个人资料图片或特定支持标识符背后的公开头像，并返回算法估算的属性。这与游戏头像工具或身份验证不同。当您手头已有图片时，请从图片人像解析开始。当仅已知电话号码或支持的电子邮箱地址时，请使用 WhatsApp 头像解析或邮箱头像解析。对于即时通讯工具来源的大型列表，请使用批量文件处理。结果属于公开来源信号和算法估算，旨在帮助团队审查记录，而非证明某人的身份。

头像解析对联系人数据的意义

头像解析的搜索结果通常混杂了多种功能：将照片转换为卡通形象的生成器、游戏角色查看器以及反向图片搜索工具。联系人数据团队通常指的是更具体的含义：了解记录所关联的图片类型，并在来源有记录的情况下，检索标识符背后的公开头像。

输出结果具有描述性。图片可以按类型进行分类，外观属性（如年龄估算、性别、发色和肤色）将作为算法估算值返回。该服务执行的是图片分析，而非人员识别，且不验证身份、所有权或账户控制权。

这种框架确保了用例的合规性。清理列表、识别图片为徽标或物体的记录以及优先进行人工审查是合理的用途。而筛选人员、追踪他们或根据外观估算做出重大决策则不在其列。

第一层：图片人像解析

当团队已经拥有图片时，图片人像解析是直接途径。它接受符合规定大小限制的 JPEG、PNG、WebP 或 GIF 格式文件。在网站上，上传或提供公开的 https 图片链接均可。图片解析的 API 路径为 multipart 文件上传。集成应发送文件本身。

该请求是同步的。答案描述的是图片而非账户，结果中的标识符源自图片内容，而非个人或账号。

两点建议有助于避免意外。即使图片显示的是宠物、卡通或物体，或者某些属性返回为无法判定，已完成的结果仍视为完整，并按已完成的答案计费。服务错误或无法读取的图片则不计费。团队应将属性作为带有日期的估算值存储，绝不能将其视为关于个人的事实。

第二层：基于标识符的公开头像

有时仅存在标识符。两种来源支持实时单次检查和同步多次检查：WhatsApp 号码，以及 Gmail、Yandex 和 Mail.ru 域名的电子邮箱地址。单次检查使用 POST /api/v1/check。多次检查使用 POST /api/v1/batch-check，每个请求支持 1 到 100 个同类服务标识符，并返回有序结果。仪表板可处理更长的粘贴内容，最多 500 个，逐一进行。

结果需要仔细解读。三种结果必须保持独立：找到公开头像、未找到公开头像，以及无法判定。WhatsApp 的帮助中心解释称，所有者可以控制谁能看到个人资料照片，因此缺少图片通常是隐私设置所致。上述任何结果均不代表账户是否存在，也不证明身份或同意。

通过 GET /api/v1/balance 进行余额检查，可以让集成在启动大规模运行前确认额度。

第三层：即时通讯来源的批量文件

Telegram、Viber、MAX、LINE 和 Zalo 仅提供批量处理产品，同时 WhatsApp 和支持的邮箱也提供批量选项。目前存在八种不同的批量产品，每种产品都有其特定的列和限制，因此绝不能将其视为一种可互换的服务。

准备工作很简单。使用每行一个标识符的 TXT 或 CSV 文件。对于电话产品，请填写不带加号的国家代码数字，并选择一个国家。用户名和邮箱产品无需国家代码。通过 POST /api/v1/bulk-tasks 提交，通过 GET /api/v1/bulk-tasks/{id} 轮询任务（频率不超过每 30 秒一次），并在成功后下载单个 CSV 文件。链接在 12 小时后过期，但可以通过再次查询任务来刷新。

来自中国大陆、香港和澳门的电话号码仅支持实时单次检查。各产品的限制列在 API 文档和定价页面中。

负责任地使用结果

良好的实践始于目的。在存储字段之前确定其用途，并缩短保留期限。合理的内部政策可能是为每个头像字段标记其来源、检查日期以及“估算值”标签。

以下习惯有助于团队规避风险：

• 称之为分析，而非识别。 结果从不确认两张图片是否显示同一个人。
• 不要根据缺失进行推断。 没有图片、链接为空或无法判定的检查结果，并不代表对账户的负面判定。
• 不要将估算值用于人员决策。 年龄或性别估算可以为数据质量审查提供参考，但不应用于决定访问权限、定价或资格。
• 仅使用公开数据。 私人头像、消息和联系人无法获取，且 LinkedIn 不是支持的来源。

简短的审查清单使这些习惯具体化：确认每个字段由哪一层产生，确认来源是否为已记录的来源之一，检查是否存储了日期，并确认下游没有任何人将估算值解读为事实。遵循同一清单的审查员可以达成一致的标签，这比任何单一结果都重要。

以这种方式使用，头像解析是一个适度且有用的输入：它引导审查员关注值得二次查看的记录，并将实际决策留给人员和更强有力的证据。

常见问题解答

头像解析与身份验证有何不同？

头像解析分析图片或检索公开头像并返回描述性属性。它不验证身份、执行 KYC 或证明账户所有权。需要这些结果的团队应使用专门的验证流程，并仅将头像字段作为辅助背景。

团队应该先尝试图片还是标识符？

当有图片可用时，请从图片人像解析开始，因为它直接描述了图片。当仅已知标识符时，请转而使用 WhatsApp 或支持的邮箱检查；当列表对于同步调用来说太大时，请使用批量文件。

团队应如何处理年龄和性别输出？

将其视为可为数据质量审查提供参考的算法估算值。它们不是人口统计学事实，不应支持歧视性筛选、追踪或其他重大决策。在每个估算值旁边记录来源和日期，有助于后续审查员正确权衡。

了解更多

选择适合您工作流程下一步的产品信息。

• 访问产品网站 →