产品指南
头像检测:哪些来源能单次查,哪些只能走批量
AvatarLookup 哪些平台支持逐个标识单次查询、哪些只能走批量文件,以及怎样读结果才不会读过头。

决定头像检测怎么融进你的流程,只有两个问题,而它们很容易被搞反顺序。第一个是:哪些平台可以逐个标识去问。第二个是:拿到答案之后,你被允许得出什么结论。第一个搞错,做出来的功能根本立不住;第二个搞错,做出来的功能建立在一个误读之上。
不是每个来源都能做单次检测
单次检测覆盖 WhatsApp、Gmail、Yandex 和 Mail.ru。Telegram、Viber、LINE、Zalo 和 MAX 是仅批量来源:它们是支持的,但只能通过文件任务,不能逐个标识查询。
这个区分必须在最早期就弄清楚,因为它决定了你要做的功能长什么样。交互式场景——CRM 里的联系人卡片、客服看单条记录、表单边填边补全——只能建立在单次检测那几个来源上。如果你关心的平台是仅批量的,围绕它的产品形态就必须是批处理:先收集标识、提交文件、稍后处理结果。
批量任务覆盖全部支持范围:WhatsApp、Telegram、Viber、LINE、Zalo、MAX、Gmail、Yandex 和 Mail.ru。单个文件最多 100,000 条、不超过 10 MB,接受 CSV、TXT 和 XLSX。
有一个平台值得明确点名,因为总有人问:LinkedIn 不支持,两种模式都不支持。
三种结果,其中只有一种是"没有"
头像结果区分三种状态:有头像、没有头像、无法判定。
只有第一种是肯定性的发现。后两种经常被一起压成"这个账号不存在",而这两种压法都是错的。"没有头像"的含义就是字面意思——这个账号没有可获取的公开头像图片;大量真实且活跃的账号从来就没设过头像。"无法判定"则是这次查询根本没得出结论,它不是一个否定结果,也不是"没有"的委婉说法。
如果你的流程把这两种都写进同一列的"未找到",你就把两种不同的"没有答案"变成了一个关于账号是否存在的错误论断,而且事后再也分不清哪些行值得重试。
头像不能证明什么
拿到的头像,是查询发生时与某个标识关联的一张公开图片。它不是身份验证、不是 KYC、不是人脸识别,也不能证明图中的人控制着这个账号。取到图片同样不代表你获得了这张图的所有权或任意复用的权利——它原本适用什么授权,查询之后仍然适用什么授权。
对外观属性同样要谨慎:呈现性别、年龄区间、发色、肤色特征这类字段,凡是返回的,都是从一张图片推算出来的算法估计值。它们只是辅助参考,不是关于某个真实个体的人口统计事实,不应当用于高影响决策、筛选、追踪,或任何当事人未同意的画像用途。
写集成之前先定模式
落到实处,这个决定只剩一个问题:你的场景需不需要在有人等着的时候给出答案?
如果需要,而且平台属于那四个单次检测来源,交互式查询可行。如果需要、但平台是仅批量的,诚实的回答是这个交互式版本做不出来——而在写集成之前发现这件事,比写完之后发现要便宜得多。如果不需要,那本来就该走文件任务,它能处理的量级是交互式路径永远达不到的。