无名网络 · QQ音乐 API 接口文档v5.2.0

1鉴权与防盗刷 已启用

为防止接口被外人盗刷流量，解析直连接口 /api/parse 已开启访问鉴权；搜索/播放等老接口默认保持开放（不影响现有插件，见 第 8 节一键全量开启）。

三种传令牌方式（任选其一）

你的访问令牌

YOUR_TOKEN复制

IP 白名单（免令牌）

下列固定 IP 调用时无需带 token，已在 .env 的 ALLOW_IPS 配置：

103.236.87.133   框架机（点歌机器人）
103.236.87.242   本站服务器
127.0.0.1        本机内部（PHP 兼容层自动放行）

手机/家宽是动态 IP，不建议加白名单，直接用 token 即可。需要新增固定 IP，在 ALLOW_IPS 用英文逗号追加后重启服务。

限流

同一公网 IP 对解析/搜索接口默认 120 次 / 分钟（RATE_LIMIT_PER_MIN 可调，0 为不限）。超限返回 429 并带 Retry-After（秒）。本机内部与白名单不受限。

鉴权返回

2音乐解析直连 /api/parse 核心

传歌名或 mid，直接得到可播放地址；默认 302 跳转即点即播。别名：/api/direct、/api/url、/api/redirect，用法完全相同。

请求参数

format 输出形式

示例（可直接点开 / 复制）

# 打开即播（302，第 1 首，128k）
http://qq.wm2213.com/api/parse?keyword=稻香&token=YOUR_TOKEN

# 第 2 首、320k
http://qq.wm2213.com/api/parse?word=稻香&n=2&quality=320&token=YOUR_TOKEN

# 只要纯直链
http://qq.wm2213.com/api/parse?word=晴天&format=text&token=YOUR_TOKEN

# 完整信息 JSON
http://qq.wm2213.com/api/parse?word=七里香&format=json&token=YOUR_TOKEN

# 用 mid 直取
http://qq.wm2213.com/api/direct?mid=003aAYrm3GE0Ac&media_mid=0020wJDo3cx0j3&token=YOUR_TOKEN复制

format=json 返回示例

{
  "code": 200, "source": "qq", "quality": "128", "index": 1,
  "mid": "003aAYrm3GE0Ac", "mediaMid": "0020wJDo3cx0j3",
  "song": {
    "title": "稻香", "name": "稻香", "singer": "周杰伦",
    "album": "魔杰座", "duration": 223,
    "cover": "https://y.qq.com/music/photo_new/T002R800x800M000....jpg",
    "pay": { "payplay": 1 }, "sizes": { "128": 3570000, "320": 8900000 }
  },
  "url": "http://qq.wm2213.com/api/stream?mid=...&media_mid=...&quality=128&token=YOUR_TOKEN",
  "streamUrl": "……同上……", "playUrl": "……同上……"
}复制

3搜索 /api/search

按歌名搜索，返回列表（默认不强制鉴权，受同一限流约束；全量开启后见第 8 节）。

返回 { code:200, source:'qq', count, index, list:[...], data:{...} }，列表项主要字段：

4详情 · 取地址 · 音频流

详情（含播放地址）

返回歌曲信息 + playUrl/streamUrl（本站流地址）；playReason 非空表示该音质不可用原因。

仅取播放地址（JSON）

返回官方 url（会过期）与本站 streamUrl（稳定）。取不到时 HTTP 404 并带 reason。

音频流（可直接作为播放器 src）

直接返回音频二进制（audio/mpeg / audio/flac 等），支持 Range 断点/拖动（200 / 206）。每次请求实时换 vkey，地址长期有效。

<audio src="http://qq.wm2213.com/api/stream?mid=003aAYrm3GE0Ac&media_mid=0020wJDo3cx0j3&quality=128&token=YOUR_TOKEN" controls></audio>复制

5歌词 /api/lyric

返回 LRC 原文、翻译、音译（均为纯文本，无则空串）：

{ "mid": "...", "lyric": "[ti:稻香]...", "trans": "翻译歌词", "roma": "音译" }复制

6点歌 DLL 兼容接口（易语言插件原契约）

下列 PHP 接口供「无名点歌.dll」按原有指令直接调用，无需带 token（由服务器本机内部转发到 Node，已自动放行）；卡片播放地址已自动附带令牌，全量开启鉴权后也能正常放歌。

搜歌列表

{ "code": 200, "data": [
  { "id":449205, "mid":"003a...", "mediaMid":"0020...", "song":"稻香",
    "singer":"周杰伦", "album":"魔杰座", "cover":"https://...", "duration":223 }
]}复制

点歌音乐卡片

n 为列表里选择的序号（默认 1）。返回 QQ 音乐卡片 JSON，DLL 读取 meta.music.musicUrl，该地址已自动带 token。

7音质、错误码与黑名单

音质 quality

错误码

后台可配置 mid / 关键词黑名单，命中的歌曲会从搜索结果过滤。健康检查：GET /api/health（登录态、Cookie 自动刷新状态）。

8防盗刷配置与运维

配置文件：/www/wwwroot/qqmusic/.env，由 systemd 服务 qqmusic.service 读取，改完需重启生效。

更换 / 增加令牌

# 编辑 .env，改成新值（可同时保留新旧两个，平滑切换）
ACCESS_TOKENS="新令牌,旧令牌"
# 保存后重启
systemctl restart qqmusic复制

全量保护老接口（搜索/音频流也要 token）

# 把 .env 中改为
AUTH_API="1"
systemctl restart qqmusic复制

常用命令

systemctl status qqmusic      # 状态
systemctl restart qqmusic     # 重启
journalctl -u qqmusic -f     # 实时日志（含 401 拦截记录 auth-deny）
curl http://127.0.0.1:3001/api/health   # 本机健康检查复制

当前访问令牌：YOUR_TOKEN（请妥善保管，勿公开）。

9调用示例

curl

# 跟随 302 直接下载/播放
curl -L -o dao.mp3 "http://qq.wm2213.com/api/parse?keyword=稻香&token=YOUR_TOKEN"
# 只取直链
curl "http://qq.wm2213.com/api/parse?word=稻香&format=text&token=YOUR_TOKEN"
# 取 JSON
curl "http://qq.wm2213.com/api/parse?word=稻香&format=json&token=YOUR_TOKEN"复制

易语言（点歌插件 / 悬浮窗思路）

' 1) 用 网页_访问S / LibCurl 请求纯直链（format=text），拿到一行 URL
直链 ＝ 网页_访问S (“http://qq.wm2213.com/api/parse?word=” ＋ 编码_URL编码(歌名)
      ＋ “&n=1&quality=128&format=text&token=YOUR_TOKEN”, , , , )

' 2) 把“直链”交给播放组件 / 浏览器框 / 音乐卡片即可播放
'    （直链为本院 /api/stream，长期有效、支持拖动）

' 更省事：直接把 302 地址交给支持跟随跳转的播放器，无需 format=text：
'   http://qq.wm2213.com/api/parse?word=歌名&token=YOUR_TOKEN复制

PHP

$url = 'http://qq.wm2213.com/api/parse?word=' . rawurlencode($name)
     . '&format=text&token=YOUR_TOKEN';
$play = trim(file_get_contents($url));   // 即可播放直链复制

网页 / H5

<audio controls
  src="http://qq.wm2213.com/api/parse?keyword=稻香&token=YOUR_TOKEN"></audio>复制