🙂 QQ头像获取
QQ头像获取 接口
本接口用于获取 QQ 用户头像，支持指定尺寸、圆形头像、圆角头像以及 JSON 返回格式。
接口地址
主用接口：https://api.ku.cm/qq/?qq=
备用接口：https://api.xk.ee/qq/?qq=
请求方式
| 请求方式 | 返回格式 |
|---|---|
| GET | 图片 / JSON |
请求参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| string | 是 | QQ号码 | |
| size | int | 否 | 头像尺寸（40 / 100 / 140 / 640） |
| circle | int | 否 | 圆形头像 (1=启用) |
| radius | int | 否 | 圆角头像 |
| type | string | 否 | json 返回格式 |
请求示例
https://api.ku.cm/qq/?qq=QQ号码
https://api.ku.cm/qq/?qq=QQ号码&size=100
https://api.ku.cm/qq/?qq=QQ号码&circle=1
https://api.ku.cm/qq/?qq=QQ号码&type=json
JSON 返回示例
{
"code":200,
"msg":"success",
"data":{
"qq":"129517573",
"size":640,
"avatar":"https://q1.qlogo.cn/g?b=qq&nk=1295917573&s=640",
"time":"2026-03-08 21:40:00",
"runtime":"0.0011s"
}
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 状态说明 |
| string | QQ号码 | |
| size | int | 头像尺寸 |
| avatar | string | 头像地址 |
| time | string | 服务器时间 |
| runtime | string | 接口响应时间 |
状态码说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 参数错误 |
| 404 | 头像不存在 |
| 405 | 请求方式错误 |
| 500 | 服务器错误 |
调用示例
HTML 调用
<img src="https://api.ku.cm/qq/?qq=1295917573">
JSON 调用
https://api.ku.cm/qq/?qq=1295917573&type=json
效果演示
普通头像：
圆形头像：
圆角头像：