/ 接口详情
/ 接口详情 · 音乐
GET / POST

QQ音乐_v2

接口提供 QQ 音乐 歌曲(搜索 / 详情 / 播放 / 歌词)、MV(搜索 / 详情 / 播放)与自定义扫码登录自有账号能力。(内置兜底账号,但每日配额有限,会员用户可自定义登录私有化部署,一次登录一个月内可直接使用)

调用 506 次 3 积分 / 次 KEY 必填 QPM 30/MIN Query 参数、Header(X-API-Key)、Bearer Token
返回接口市场
接口信息
GET / POST api.suol.cc/v1/music_qq_v2
方法
GET / POST
分类
音乐
计费
3 积分 / 次
KEY
KEY 必填
调用
506
QPM
30/MIN
鉴权
Query 参数、Header(X-API-Key)、Bearer Token
作者

请求参数

参数名类型必填说明示例
key string 是 接口调用密钥
action string 是 操作类型,仅可为:login_qr(获取扫码登录二维码可自定义账号,当兜底账号不可用时建议)、search(歌曲搜索)、detail(歌曲详情)、play(歌曲播放,返回直链)、lyric(歌曲歌词)、mv_search(MV 搜索)、mv_detail(MV 详情)、mv_play(MV 播放)
keyword string 否 搜索关键词,仅当 action 为 search、mv_search 时必填;等价参数 q
q string 否 keyword 的别名,二者同时存在时优先 keyword
page integer 否 页码,仅当 action 为 search、mv_search 时有效,从 1 开始;与 offset 二选一
offset integer 否 分页偏移,仅当 action 为 search、mv_search 时有效,从 0 开始;与 page 二选一
limit integer 否 每页条数,仅当 action 为 search、mv_search 时有效,默认 20,最大 50
search_id string 否 搜索会话 ID,仅当 action 为 search、mv_search 时有效,用于翻页续搜;由首次搜索返回
song_mid string 否 歌曲 mid(QQ 音乐 14 位字符串),仅当 action 为 detail、play、lyric 时必填;等价参数 mid
mid string 否 song_mid 的别名,二者同时存在时优先 song_mid
quality string 否 音质,仅当 action 为 play 时有效,仅可为:standard(标准 128k)、hq(高品质 320k)、sq(无损 flac)、dolby(杜比)、xq(臻品母带)、pq(臻品全景声)、accom(伴奏);默认 standard,未开通的档位自动降级
format string 否 音源封装,仅当 action 为 play 时有效,仅可为:mp3(audio/mpeg,浏览器直接播)、m4a(audio/mp4)、flac(无损)、mgg(QQ音乐私有加密封装,浏览器不可直接解码);默认 mp3
lyric_format string 否 歌词格式,仅当 action 为 lyric 时有效,仅可为:lrc(纯文本,默认)、krc(逐字加密)、qrc(逐字加密)、txt(纯文本);未登录时自动降级为 lrc
mv_mid string 否 MV mid(QQ 音乐 11 位字符串),仅当 action 为 mv_detail、mv_play 时必填;等价参数 vid
vid string 否 mv_mid 的别名,二者同时存在时优先 mv_mid
mv_quality string 否 MV 清晰度,仅当 action 为 mv_play 时有效,仅可为:sd(标清)、hd(高清,默认)、fhd(超清)、uhd(蓝光);以上游返回档位为准,未开通自动降级
uin string 否 action为:login_qr登录后的会员账号(登录一次一个月有效),非会员账号无法登录,当兜底账号不可用时建议自备会员(绿钻)账号 1828222534
song_id string 否 当action为play时,必填 歌曲id(这里不是mid而是返回的id的值)
推荐接口