基于 qqmusic-api-python 的增强 REST API 服务，提供简洁易用的音乐数据接口。所有 API 端点详见下方分组。
| GET/api/v2/auth/status | 检查登录状态，支持自动续登 |
| POST/api/v2/auth/refresh | 手动刷新登录凭据并保存到 .env |
| POST/api/v2/auth/qr/start | 生成二维码（QQ / 微信 / 手机） |
| GET/api/v2/auth/qr/status | 轮询二维码登录状态 |
| POST/api/v2/auth/qr/cancel | 取消二维码会话 |
| GET/api/v2/search | 搜索歌曲 |
| GET/api/v2/search/singers | 搜索歌手 |
| GET/api/v2/search/albums | 搜索专辑 |
| GET/api/v2/search/mvs | 搜索 MV |
| GET/api/v2/search/songlists | 搜索歌单 |
| GET/api/v2/search/hotkey | 获取热搜词 |
| GET/api/v2/search/complete | 搜索补全建议 |
| GET/api/v2/song/cdn-dispatch | 获取 CDN 域名列表 |
| GET/api/v2/song/urls | 获取播放链接（16 种音质） |
| GET/api/v2/song/lyric | 获取歌词（含翻译/罗马音） |
| GET/api/v2/song/comments | 获取歌曲评论 |
| GET/api/v2/song/cover | 获取专辑封面（多尺寸） |
| GET/api/v2/song/similar | 获取相似歌曲 |
| GET/api/v2/song/versions | 获取其他版本 |
| GET/api/v2/song/official-mv | 获取官方 MV |
| GET/api/v2/song/related-mv | 获取相关 MV 列表 |
| GET/api/v2/song/mv/urls | 获取 MV 播放链接 |
| GET/api/v2/singer/info | 获取歌手基本信息 |
| GET/api/v2/singer/desc | 获取歌手简介 |
| GET/api/v2/singer/songs | 获取歌手歌曲列表（分页） |
| GET/api/v2/singer/albums | 获取歌手专辑列表（分页） |
| GET/api/v2/singer/mvs | 获取歌手 MV 列表（分页） |
| GET/api/v2/singer/similar | 获取相似歌手 |
| GET/api/v2/album/detail | 获取专辑详情 |
| GET/api/v2/album/songs | 获取专辑歌曲列表（分页） |
| GET/api/v2/songlist/detail | 获取歌单详情及歌曲 |
| POST/api/v2/me/songlists/create | 创建歌单 |
| POST/api/v2/me/songlists/delete | 删除歌单 |
| POST/api/v2/me/songlists/add-songs | 添加歌曲到歌单 |
| POST/api/v2/me/songlists/remove-songs | 从歌单移除歌曲 |
| GET/api/v2/top/categories | 获取排行榜分类列表 |
| GET/api/v2/top/detail | 获取排行榜歌曲详情（分页） |
| GET/api/v2/recommend/songlists | 获取每日推荐歌单 |
| GET/api/v2/recommend/newsongs | 获取每日推荐新歌 |
| GET/api/v2/recommend/guess | 根据听歌习惯推荐歌曲 |
| GET/api/v2/me/songlists | 获取我的歌单 |
| GET/api/v2/me/fav-songs | 获取我喜欢的歌曲 |
| GET/api/v2/me/fav-songlists | 获取收藏的歌单 |
| GET/api/v2/me/fav-albums | 获取收藏的专辑 |
| GET/api/v2/me/fav-mvs | 获取收藏的 MV |
| GET/api/v2/me/vip | 获取 VIP 信息 |
| GET/api/v2/me/music-gene | 获取音乐基因（听歌偏好统计） |
| POST/api/v2/me/like-song | 将歌曲添加到「我喜欢」 |
| POST/api/v2/me/unlike-song | 从「我喜欢」移除歌曲 |
所有 /api/v2/* 接口需要在请求头中携带 Token：
Authorization: Bearer QQMUSIC_PLUS_API_TOKEN的值
其中 QQMUSIC_PLUS_API_TOKEN 在 .env 文件中配置。如未配置该环境变量，则无需认证直接访问。