[使用帮助] 获取用户头像与群头像的方法

[Ceale]

API

• 用户头像：https://thirdqq.qlogo.cn/g?b=sdk&s={size}&nk={user_id}
• 群头像：https://p.qlogo.cn/gh/{group_id}/{group_id}/{size}

参数

• size: 100 或 640 或 0　—　图片尺寸，为 0 可以获得可能是原图质量的图片
• user_id: number　—　qq号
• group_id: number　—　群号

---

原标题

[API请求] 希望提供一个获取群头像的API

原内容

如题。或者还有其他获取群头像的api吗？
#917 所提供的api获取的图片清晰度太低，远不及 #921 中的api获取的清晰。

非常感谢开发者的持续维护❤

[AQiaoYo]

感谢您的反馈和建议！

关于获取高清群头像的需求，目前其实可以直接使用QQ的头像服务，无需通过本框架的API。您可以使用以下格式的链接：

https://q1.qlogo.cn/g?b=qq&s=640&nk={group_id}

只需将 {group_id} 替换为实际的群号即可。这是QQ官方提供的高清头像服务（640×640 分辨率），应该能够满足您对清晰度的要求。

因此，考虑到已有这样稳定可靠的替代方案，我们暂不考虑为此单独添加新的官方API。这样可以保持框架的简洁性，也避免了重复造轮子。

感谢您对项目的理解与支持！如果还有其他问题，欢迎随时提出。❤

[Ceale]

您确定这个是获取群头像的api吗，我获取到的似乎是和群号同Q号的用户头像。
https://q1.qlogo.cn/g?b=qq&s=640&nk=1064962014

[AQiaoYo]

您说得对！群头像的正确链接格式应该是：

https://p.qlogo.cn/gh/{group_id}/{group_id}/640

只需将 {group_id} 替换为实际的群号即可。这是QQ官方提供的群头像服务（640×640 分辨率），能够获得高清的群头像图片。

因此，考虑到已有稳定可靠的官方服务可用，我们暂不考虑为此单独添加新的API。这样可以保持框架的简洁性，也让您能直接获得最清晰的群头像。

感谢您对项目的理解与支持！如果还有其他问题，欢迎随时提出。❤

[sj817]

@Ceale

[Ceale]

好的，刚刚没认真看。感谢

[AQiaoYo]

补充说明：关于高清群头像的获取方案

根据社区成员的进一步研究，对于高清群头像的获取，还有以下发现：

更高清/原图的参数方案：

https://p.qlogo.cn/gh/{group_id}/{group_id}/0

或者

https://p.qlogo.cn/gh/{group_id}/{group_id}/

参数说明：

• 将尺寸参数设置为 0 或不传参时，可能会返回原始尺寸的头像
• 这种方式通常能获得比固定尺寸（如640）更高质量的图片

建议：

• 如需最高清晰度，可暂时使用上述方案
• 但在生产环境中建议做好兼容处理，以防接口变更
• 可以同时缓存头像图片，避免频繁请求

感谢各位的深入研究和分享！如果后续有更稳定的官方方案出现，我们会及时同步给大家。