Telegram 账号头像 API - 逆行者联盟

接口基本信息

请求方式	GET
接口地址	https://api.nxzlm.com/tg-avatar/api.php
支持跨域	是
注意限制	依赖服务器网络质量，若请求频繁可能被 TG 暂时限制

请求参数 (GET)

参数名	类型	必填	说明
username	String	是	Telegram 的用户名 (例如: `QiuShuYa`，不带 @)
format	String	否	返回格式。可选值： json (默认，返回 JSON 解析数据) image (直接302重定向到图片，常用于直接插入 img 标签)

JSON 格式返回示例

请求：https://api.nxzlm.com/tg-avatar/api.php?username=QiuShuYa

{
    "code": 200,
    "msg": "success",
    "data": {
        "username": "QiuShuYa",
        "avatar": "https://cdn4.telegram-cdn.org/file/...",
        "source": "https://t.me/QiuShuYa"
    }
}

直接输出图片 (Image) 示例

你可以直接将此 API 作为 <img> 标签的 src：

<img src="https://api.nxzlm.com/tg-avatar/api.php?username=QiuShuYa&format=image" alt="头像">

如果使用了 format=image，系统会自动重定向到 TG 头像的 CDN 真实地址，如果账号不存在则返回一个默认的占位图（或404错误）。

接口在线测试

TG 头像获取 API