插件概述
本插件基于Quart框架开发，用于提取QQ音乐歌单中的歌曲基础信息，支持获取完整歌单列表、指定单曲详情、限制获取歌曲数量等功能，同时修复了歌单封面URL拼接错误的问题，兼容本地与服务器环境运行。
突破30首接口限制，自动分页获取全部歌曲
修复封面URL拼接错误，支持高清封面
灵活参数控制，支持指定数量/指定单曲获取
完善的错误处理，返回用户友好提示
接口信息
| 项目 | 详情 |
|---|---|
| 接口路径 | https://apicx.asia/api/qqmusic_extractor |
| 请求方法 | GET |
| 认证方式 | Token验证（URL参数/Header） |
| 核心功能 | 提取歌单信息、单曲信息，支持数量限制 |
请求参数说明
| 参数名 | 必选 | 类型 | 取值说明 |
|---|---|---|---|
| id | 是 | 字符串 | QQ音乐歌单ID（可从歌单分享链接中提取） |
| token | 是 | 字符串 | 接口访问Token（必填认证参数） |
| n | 否 | 整数 | 歌单中歌曲的序号，用于获取指定单曲 |
| all | 否 | 布尔 | true 表示获取全部歌曲详情；不传或 false 为基础模式 |
| limit | 否 | 整数 | 限制获取的歌曲数量，如 limit=30 表示仅获取前30首 |
Token使用说明
Token可通过两种方式传递：
1. URL参数：token=your_token_here
2. 请求头：Authorization: Bearer your_token_here
歌单ID提取示例
歌单ID提取示例：分享链接 https://y.qq.com/n/ryqq/playlist/123456789 中的 123456789 即为歌单ID
调用方式及示例
方式1：获取歌单基础信息+全部歌曲列表
请求URL：
https://apicx.asia/api/qqmusic_extractor?id=123456789&token=your_token_here
返回结果：
{
"code": 200,
"data": {
"playlist_info": {
"playlist_id": "123456789",
"title": "精选抖音最火伤感歌曲",
"description": "精选抖音最火伤感歌曲，哪一首能打动你呢？ 图源Pinterest 侵删 持续更新喔 有任何建议欢迎评论区指出♪",
"total_songs": 309,
"play_count": 505121054,
"creator": "音乐爱好者",
"cover_url": "https://qpic.y.qq.com/music_cover/hKFribMhwH4ClwNWJxicuCxuQIpoIRtGZuTvQ2VLkSAPIUpGC9kR34AA/800.jpg"
},
"songs": [
{
"index": 1,
"song_id": "10897654",
"song_mid": "003XyP932k4Y8R",
"song_name": "字字句句",
"singer": "张碧晨",
"album_name": "字字句句",
"duration": "03:52",
"cover_url": "https://y.qq.com/music/photo_new/T002R800x800M000003XyP932k4Y8R.jpg"
},
{
"index": 2,
"song_id": "10987653",
"song_mid": "001XyQ932k5Y8S",
"song_name": "后来的我们",
"singer": "五月天",
"album_name": "自传",
"duration": "05:40",
"cover_url": "https://y.qq.com/music/photo_new/T002R800x800M000001XyQ932k5Y8S.jpg"
}
],
"count": 309,
"message": "成功获取 309 首歌曲（歌单总数：309），使用 n=序号 参数获取单曲详情，或使用 all=true 获取全部歌曲详情"
},
"timestamp": "2025-12-19 20:00:00"
}
方式2：获取指定序号的单曲详情
请求URL（获取第5首）：
https://apicx.asia/api/qqmusic_extractor?id=123456789&n=5&token=your_token_here
返回结果：
{
"code": 200,
"data": {
"index": 5,
"song_id": "11078945",
"song_mid": "008XyA932k8Y7P",
"song_name": "花海",
"singer": "周杰伦",
"album_name": "魔杰座",
"duration": "04:22",
"cover_url": "https://y.qq.com/music/photo_new/T002R800x800M000008XyA932k8Y7P.jpg"
},
"timestamp": "2025-12-19 20:05:00",
"message": "成功获取第 5 首歌曲详情"
}
方式3：获取全部歌曲的完整详情
请求URL：
https://apicx.asia/api/qqmusic_extractor?id=123456789&all=true&token=your_token_here
返回结果：
{
"code": 200,
"data": {
"playlist_info": {
"playlist_id": "123456789",
"title": "精选抖音最火伤感歌曲",
"description": "精选抖音最火伤感歌曲，哪一首能打动你呢？ 图源Pinterest 侵删 持续更新喔 有任何建议欢迎评论区指出♪",
"total_songs": 309,
"play_count": 505121054,
"creator": "音乐爱好者",
"cover_url": "https://qpic.y.qq.com/music_cover/hKFribMhwH4ClwNWJxicuCxuQIpoIRtGZuTvQ2VLkSAPIUpGC9kR34AA/800.jpg"
},
"songs": [
{
"index": 1,
"song_id": "10897654",
"song_mid": "003XyP932k4Y8R",
"song_name": "字字句句",
"singer": "张碧晨",
"album_name": "字字句句",
"duration": "03:52",
"cover_url": "https://y.qq.com/music/photo_new/T002R800x800M000003XyP932k4Y8R.jpg"
}
],
"count": 309,
"message": "成功获取 309 首歌曲的详细信息（歌单总数：309）"
},
"timestamp": "2025-12-19 20:10:00"
}
方式4：限制获取歌曲数量（前30首）
请求URL：
https://apicx.asia/api/qqmusic_extractor?id=123456789&limit=30&token=your_token_here
返回结果：
{
"code": 200,
"data": {
"playlist_info": {
"playlist_id": "123456789",
"title": "精选抖音最火伤感歌曲",
"description": "精选抖音最火伤感歌曲，哪一首能打动你呢？",
"total_songs": 309,
"play_count": 505121054,
"creator": "音乐爱好者",
"cover_url": "https://qpic.y.qq.com/music_cover/hKFribMhwH4ClwNWJxicuCxuQIpoIRtGZuTvQ2VLkSAPIUpGC9kR34AA/800.jpg"
},
"songs": [
{
"index": 1,
"song_id": "10897654",
"song_mid": "003XyP932k4Y8R",
"song_name": "字字句句",
"singer": "张碧晨",
"album_name": "字字句句",
"duration": "03:52",
"cover_url": "https://y.qq.com/music/photo_new/T002R800x800M000003XyP932k4Y8R.jpg"
}
],
"count": 30,
"message": "成功获取前 30 首歌曲（歌单总数：309）"
},
"timestamp": "2025-12-19 21:00:00"
}
方式5：混合调用（all=true+limit=30）
请求URL（获取前30首完整详情）：
https://apicx.asia/api/qqmusic_extractor?id=123456789&all=true&limit=30&token=your_token_here
返回结果：
{
"code": 200,
"data": {
"playlist_info": {
"playlist_id": "123456789",
"title": "精选抖音最火伤感歌曲",
"total_songs": 309,
"cover_url": "https://qpic.y.qq.com/music_cover/hKFribMhwH4ClwNWJxicuCxuQIpoIRtGZuTvQ2VLkSAPIUpGC9kR34AA/800.jpg"
},
"songs": [
{
"index": 1,
"song_id": "10897654",
"song_name": "字字句句",
"singer": "张碧晨",
"duration": "03:52"
}
],
"count": 30,
"message": "成功获取 30 首歌曲的详细信息（歌单总数：309）"
},
"timestamp": "2025-12-19 21:15:00"
}
错误返回示例
| 错误类型 | 返回示例 |
|---|---|
| 缺少歌单ID |
{
"code":500,
"message":"歌单ID不能为空",
"timestamp":"2025-12-19 22:00:00"
}
|
| 缺少Token |
{
"code":401,
"message":"未授权访问：缺少Token参数",
"timestamp":"2025-12-19 22:02:00"
}
|
| Token无效 |
{
"code":403,
"message":"Token无效或已过期，请重新获取",
"timestamp":"2025-12-19 22:03:00"
}
|
| 歌单不存在 |
{
"code":500,
"message":"获取歌单信息失败: 歌单不存在或已失效",
"timestamp":"2025-12-19 22:05:00"
}
|
| 服务连接失败 |
{
"code":500,
"message":"获取歌单信息失败: 服务连接失败，请稍后重试",
"timestamp":"2025-12-19 22:10:00"
}
|
注意事项
- 非登录状态下，部分私密歌单可能无法获取，可添加登录Cookie提升兼容性
- 建议添加请求频率限制，避免高频请求被QQ音乐接口拦截
- 插件自动处理接口分页，默认最多获取1500首歌曲，防止无限循环
- 封面URL支持800x800高清分辨率，可根据需求调整为300x300/120x120等
- Token有效期请参考接口提供方说明，过期后需重新获取
- 请勿将Token泄露给第三方，避免接口被滥用
在线测试工具
{
"message": "请填写参数并点击发送请求"
}