累计调用 22 次

QQ 多选点歌（支持 vip 和自定义音质）

正常未配置 Cookie JSON

内置普通会员，高音质请自行传入 ck 参数。

普通可选：
mp3 普通音质 · hq 高品质 · flac 无损

超级可选：
master 母带音质 · atmos_2 臻品音质 2.0 · atmos_51 全景声 5.1

请求地址

GET / POST 均可，返回 UTF-8 JSON

GET https://apiss.zhuwang.me/api/?msg=洛天依微光&key=qqm_05b7a61aaa0451d68a8aa5af

GET https://apiss.zhuwang.me/api/?msg=洛天依微光&n=1&quality=hq&key=qqm_05b7a61aaa0451d68a8aa5af

请求参数

带 * 为必填

参数	必填	类型	说明
msg	是	string	歌曲名 / 歌手，也可写成「歌名歌手」。别名：`w`、`keyword`、`name`
n	否	int	选第几首。不传返回搜索列表；传了就返回该首的播放直链（从 1 开始）
quality	否	string	音质：`mp3` / `hq` / `flac` / `master` / `atmos_2` / `atmos_51`，默认取后台设置
limit	否	int	列表返回条数，默认 10，最大 50
page	否	int	页码，默认 1
ck	否	string	你自己的 QQ 音乐 Cookie（含 `qm_keyst`），用于取 VIP / 高音质。不传则用后台内置的
key	是*	string	API Key。后台开启鉴权时必填

另有独立接口：/api/?act=play&mid=歌曲MID&quality=hq 直接按 MID 取链接；/api/?act=lyric&mid=歌曲MID 只取歌词。

返回示例（搜索列表）

请求：?msg=洛天依微光（不带 n）

JSON

{
  "code": 200,
  "msg": "请求成功",
  "data": {
    "name": "洛天依 微光",
    "text": "1: 微光 - 洛天依/星见/穿越火线: 枪战王者\n2: 微光 - 某某",
    "simplify": "1: 微光 - 洛天依 * 微光\n2: 微光 - 某某 * 微光",
    "songs": [
      {
        "n": 1,
        "name": "微光",
        "singer": "洛天依/星见/穿越火线: 枪战王者",
        "album": "微光",
        "pay": "[收费]",
        "mid": "003kfFex37Ld2s"
      }
    ]
  }
}

返回示例（选择序号 n=1）

请求：?msg=洛天依微光&n=1&quality=hq

JSON

{
  "code": 200,
  "msg": "请求成功",
  "data": {
    "name": "微光",
    "singer": "洛天依/星见/穿越火线: 枪战王者",
    "album": "微光",
    "picture": "https://y.qq.com/music/photo_new/T002R800x800M000....jpg",
    "vip": "内置普通会员-无需cookie",
    "interval": "3:28",
    "music_url": {
      "url": "https://dl.stream.qqmusic.qq.com/M800003kfFex37Ld2s003kfFex37Ld2s.mp3?vkey=xxx&guid=xxx",
      "bitrate": "320kbps",
      "format": "mp3",
      "cached_size": "hq",
      "actual_size": "hq"
    },
    "mid": "003kfFex37Ld2s",
    "musicurl": "https://dl.stream.qqmusic.qq.com/M800....mp3?vkey=xxx",
    "lrctxt": "[00:00.00]歌词内容...",
    "html": "https://y.qq.com/n/ryqq/songDetail/003kfFex37Ld2s",
    "picurl": "https://y.qq.com/music/photo_new/T002R500x500M000....jpg",
    "vipmusicurl": "",
    "vipicr": "",
    "pay": "[收费]",
    "n": 1
  }
}

返回字段说明

字段	类型	说明
code	int	200 成功；401 鉴权失败；404 无结果；429 限流；500 失败
msg	string	提示信息
data.text	string	列表模式下拼好的文本，每行 `序号: 歌名 - 歌手`，可直接给用户展示
data.simplify	string	简化文本，每行 `序号: 歌名 - 主歌手 * 专辑`
songs[].pay	string	`[收费]` 或 `[免费]`
music_url.url	string	播放直链，可直接给 `<audio>` / 播放器使用，带有效期
music_url.bitrate	string	实际音质文案，如 320kbps / FLAC
music_url.actual_size	string	实际返回的音质标识（请求音质无权限时自动降级）
interval	string	时长，`m:ss`
lrctxt	string	LRC 歌词，无歌词返回空字符串
html	string	QQ 音乐网页版歌曲页

在线调试

直接调用当前站点的接口，验证是否可用

响应

点击「发送请求」查看结果…

常见问题

问题	处理
返回 500「未取到播放地址」	该曲目需要 VIP。到后台扫码登录有会员的 QQ 号，或在请求里带 `ck` 参数。
请求的音质没生效	无权限时接口会自动降级，看返回的 `actual_size` 字段才是真实音质。
直链过一段时间失效	QQ 音乐直链带 `vkey`，有效期约几小时。播放前重新请求一次即可，不要长期缓存。
返回 401	后台开启了鉴权，请求需带 `key=你的API Key`。
返回 429	触发限流，等待一分钟后重试或到后台调高限制。