SuperAPI AI 工具集

unavatar-api

编程与开发

查看项目

更新于 10-16 00:30

技能介绍

用途:通过 https://unavatar.io 单一端点,从 40 多个平台解析用户头像,支持按邮箱、用户名或域名三种输入方式。

主要能力:用 /:provider/:key 指定平台与标识,或直接传入邮箱路径段自动解析(无 provider 前缀时按 Gravatar、GitHub 顺序)。返回内容默认是图片,传 json 参数则返回包含 status、message、data 等字段的 JSON。

用法示例:邮箱自动解析用 https://unavatar.io/hello@microlink.io;指定平台用 https://unavatar.io/github/kikobeats;域名用 https://unavatar.io/google/reddit.com。Pro 请求加请求头:curl -H "x-api-key: YOUR_API_KEY" https://unavatar.io/instagram/kikobeats。密钥用量查询 https://unavatar.io/key/usage,轮换 https://unavatar.io/key/rotate。

查询参数:ttl 控制缓存时长,默认 24h,范围 1h 到 28d,自定义需 Pro;fallback 可在解析失败时返回外部图片、静态图、Base64 或 false(返回 404);json 返回 JSON。

计费与限制:免费无需认证,每日每 IP 50 次;Pro 按 token 计费,$0.001/token。代理层级影响 token 数:Origin 1、Datacenter +2、Residential +4。响应头包含 x-pricing-tier、x-unavatar-cost、x-proxy-tier 及免费层速率限制信息。错误分为客户端 fail(4xx)与服务端 error(5xx),带稳定错误码。部分平台与自定义 ttl 属 Pro。

适用场景:需要为多平台用户档案统一显示头像的前端或后端集成。