名称	参数	必填	说明
开发者ID	id	是	用户中心的数字ID，例：id=10000000
开发者KEY	key	是	用户中心通讯秘钥，例：key=15he5h15ty854j5sr152hs2
数量	num	否	返回头像数量，默认1，最多30个，例：num=30
动态秘钥	dkey	否	开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371
用户IP	uip	否	接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻/炫钻/焱钻会员专享。

返回参数说明

名称	参数	说明
状态码	code	200成功，400错误
消息内容	msg	消息提示。
头像地址集	data	头像地址数据集。头像大小从30像素-140像素不等。
头像库数量	maxid	当前头像库最大头像数量，实时更新数量。

返回数据示例

示例：{"code":400,"msg":"通讯秘钥错误。"}
示例：
{
    "code": 200,
    "data": ["https://qqtx.apihz.cn/img/qqtx/1/dae/dae6317b02b7716f3e6bd516a8ca72bb.jpg", "https://qqtx.apihz.cn/img/qqtx/1/fa1/fa107db89de8ab6730f285ba02b3135c.jpg", "https://qqtx.apihz.cn/img/qqtx/1/3d2/3d22f767f69e617b25f46aca994b2b20.jpg", "https://qqtx.apihz.cn/img/qqtx/1/070/0707ebaba919a6b4d032add6b772a243.jpg", "https://qqtx.apihz.cn/img/qqtx/1/9fb/9fb9e3751cf4e3dc3d9bd244ae2d4291.jpg", "https://qqtx.apihz.cn/img/qqtx/1/8ec/8eccc1051565552d5576752145f1fe5a.jpg", "https://qqtx.apihz.cn/img/qqtx/1/c40/c408d96ecd448196acbb8a48adcd9ea3.jpg", "https://qqtx.apihz.cn/img/qqtx/1/8d9/8d9cfa4b7fef1fbc4469106622180fa9.jpg", "https://qqtx.apihz.cn/img/qqtx/1/5ea/5ea556bac1150d8879215ec889b75614.jpg", "https://qqtx.apihz.cn/img/qqtx/1/2ec/2ec6efaf31e2e4b3edc95719d9cbf1a5.jpg"],
    "maxid": "1145810"
}

更新记录

2025-03-13 15:56:32 - 新增请求参数【num】，返回头像数量。默认1，最多30个。更新返回字段【data】用于存储头像数据集。

2025-03-08 21:45:01 - 新增接口。

图像壁纸-随机头像图片[QQ用户头像-千万头像库]-2025-03-15 17:42:42

本接口头像图片均采集于QQ用户公开头像，不存在隐私侵犯，请用于正规用途。资源库已过滤重复头像。

调用限制

调用权限	非定制接口直接使用
单价/次	免费[无上限]
单日[所有用户之和]	999999999
1分钟并发[所有用户之和]	999999999
1小时并发[所有用户之和]	999999999
频次限制[注册用户]	10次/分钟\|每日无上限
频次限制[钻石会员]	最高8000+次/分钟\|每日无上限
频次限制[定制频次]	联系我们定制

调用方法

请求方式	GET/POST
返回格式	JSON
编码格式	UTF-8

调用信息

浏览量	4013
今日总计调用	721
昨日总计调用	3702
历史总计调用	1272102
今日排名	67
总排名	89

自检信息

自检日志

自检启用状态	已启用
自检节点	上海
自检线路	彩钻接口线路
自检时间	2026-04-21 12:48:27
自检耗时	23 毫秒
自检状态	正常
历史自检成功数	149747 次
历史自检失败数	10 次
历史自检成功率	99.99 %
今日自检成功数	195 次
今日自检失败数	0 次
今日自检成功率	100.00 %