把 QQ 音乐能力接到你自己的应用
统一 JSON 响应，一条聚合接口即可拿回封面、直链、歌词与歌曲信息。本页可直接试调，也可复制 curl / fetch 示例。
Base:
成功 code = 0
推荐先登录再取高音质
约定与地址
所有接口返回 JSON：{ code, message, data }。code === 0 表示成功。
| 页面 | 路径 | 说明 |
|---|---|---|
| 解析首页 | / | 粘贴链接可视化解析 |
| API 教程 | /docs | 本页 |
| 配置中心 | /config | 平台 / 音质 / 设备（需口令） |
| 登录管理 | /login | 扫码登录获取凭证 |
| 健康检查 | /health | 探活与登录态 |
快速体验 · 聚合解析
输入 songmid、数字 id 或分享链接，调用 /song/parse。
点击「请求」查看响应…
聚合接口 /song/parse
GETPOST/song/parse
一次返回封面、播放直链、歌词与歌曲信息。未登录时直链可能为空，请先到登录页扫码。
| 参数 | 说明 |
|---|---|
mid / id / url / input | 必填其一 |
type | 音质；默认 AI00，并自动降级：母带→Hi-Res→无损→标准；也可传 auto |
decode | 默认 1 解密歌词 |
raw | 1 附加原始字段 |
成功时 data 主要字段：
| 字段 | 说明 |
|---|---|
name / singer / album | 歌曲基础信息 |
cover / covers | 封面（含 small / medium / large） |
url / quality / qualityLabel | 最终命中的直链与音质（如 母带 / Hi-Res） |
qualityCascade / qualityTried | 降级链路与实际尝试过的音质 |
urlError | 全部失败时的原因 |
lyric / lyricTrans / lyricRoma | 歌词（已尽量转为可读 LRC） |
duration / vip | 时长（秒）、是否 VIP |
搜索
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /search/hotkey | 热搜词 |
| GET | /search/complete?keyword=晴天 | 补全 |
| GET | /search/quick?keyword=晴天 | 快速搜索（适合取 mid） |
| POST | /search/general | 综合搜索 |
| POST | /search/byType | 按类型搜索 |
歌曲拆分接口
需要单独取某一项时使用；一般优先用聚合接口。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /song/detail?mids=xxx | 详情 |
| GET | /song/urls?mids=xxx&type=M800 | 直链 |
| GET | /song/lyric?mid=xxx&decode=1 | 歌词 |
| GET | /song/similar?songid=数字ID | 相似歌曲 |
音质代码
| 代码 | 说明 | 代码 | 说明 |
|---|---|---|---|
| DT03 | DTS:X | AI00 | 臻品母带 |
| Q000 | 臻品音质 | Q001 / Q003 | 臻品全景声 |
| D004 | 杜比全景声 | F000 | SQ 无损 |
| O801 / O800 | OGG 640 / 320 | M800 / M500 | MP3 320 / 128 |
| C600 / C400 / C200 | ACC | TL01 | AICodec |
登录相关
高音质直链通常需要有效登录凭证。推荐使用 Web：打开 /login 扫码。也可以调用 API：
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /login/status | 登录状态 |
| POST | /login/qrcode | 获取二维码 |
| POST | /login/checkQrcode | 轮询扫码结果 |
| POST | /login/refresh | 刷新凭证 |
配置页面
可视化修改平台、默认音质、调试开关与设备指纹。打开配置中心，使用内置管理员口令登录即可。
PORT=4545 npm start
# 浏览器打开 /config ，输入管理员口令登录| 可配置项 | 说明 |
|---|---|
| platform | android / desktop / web（热更新） |
| defaultQuality | 聚合接口默认音质 |
| debug | 调试日志开关 |
| 设备指纹 | 编辑 / 重新生成 device.json |