KuGouMusic API
酷狗音乐 NodeJS 版 API
环境要求
需要 NodeJS 12+ 环境
工作原理
跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API
功能特性
登录刷新登录发送验证码dfid 获取获取用户额外信息获取用户 vip 信息获取用户歌单获取用户云盘获取用户云盘音乐 URL获取用户收藏的视频获取用户喜欢的视频获取用户关注歌手获取用户听歌历史排行获取用户最近听歌历史获取继续播放信息（对应手机版首页显示继续播放入口）收藏歌单/新建歌单取消收藏歌单/删除歌单对歌单添加歌曲对歌单删除歌曲新碟上架专辑信息专辑详情专辑音乐列表获取音乐 URL获取音乐 URL（新版）获取歌曲高潮部分搜索默认搜索关键词综合搜索热搜列表搜索建议歌词搜索获取歌词歌单分类歌单主题歌单音效歌单获取歌单详情获取歌单所有歌曲获取歌单所有歌曲（新版）相似歌单获取主题歌单所有歌曲获取主题音乐获取主题音乐详情歌曲推荐获取歌手和专辑图片获取歌手图片获取音乐相关信息获取更多音乐版本获取音乐伴奏信息获取音乐k歌数量获取音乐详情获取音乐专辑/歌手信息私人 FM(对应手机和 pc 端的猜你喜欢)banner乐库 banner乐库电台乐库电台 - 推荐电台电台 - 图片电台 - 音乐列表编辑精选编辑精选数据编辑精选歌单编辑精选专区编辑精选专区详情领取 VIP（需要登陆，该接口为测试接口，仅限概念版使用）领取一天 VIP（需要登陆，该接口为测试接口，仅限概念版使用）获取当月已领取 VIP 天数（需要登陆，该接口为测试接口，仅限概念版使用）获取已领取 VIP 状态（需要登陆，该接口为测试接口，仅限概念版使用）获取歌手列表获取歌手详情获取歌手专辑获取歌手单曲获取歌手 MV关注歌手取消关注歌手获取关注歌手新歌获取视频 url获取歌曲 MV获取视频相关信息获取视频详情新歌速递场景音乐列表场景音乐详情获取场景音乐讨论区获取场景音乐模块 Tag获取场景音乐歌单列表获取场景音乐视频列表获取场景音乐音乐列表每日推荐历史推荐风格推荐排行列表排行榜推荐列表排行榜往期列表排行榜信息排行榜歌曲列表歌曲收藏数歌曲评论数歌曲评论歌曲评论-根据分类返回歌曲评论-根据热词返回楼层评论歌单评论专辑评论提交听歌历史获取服务器时间刷刷AI 推荐曲谱 - 获取歌曲曲谱曲谱 - 曲谱排行榜曲谱 - 曲谱详情曲谱 - 曲谱广场曲谱 - 曲谱标签频道 - 获取用户所有频道频道 - 详情频道 - 频道安利频道 - 相似频道频道 - 订阅频道 - 音乐故事频道 - 音乐故事详情动态 - 最常访问获取用户公开的音乐听书 - 每日推荐听书 - 排行榜推荐听书 - VIP 推荐听书 - 每周推荐听书 - 专辑详情听书 - 专辑音乐列表歌曲详情 - 歌曲成绩单歌曲详情 - 歌曲成绩单详情听歌识曲获取已购单曲获取已购专辑上传音乐到云盘
安装
$ git clone git@github.com:MakcRe/KuGouMusicApi.git
$ cd KuGouMusicApi
$ npm install
使用接口为概念版
$ 复制 .env.example 为 .env，并且把里面的 `platform=''` 改为 `platform=lite`
$ 注意不同版本的平台的 token 是不通用的。
运行
$ npm run dev
服务器启动默认端口为 3000, 若不想使用 3000 端口 , 可使用以下命令 : Mac/Linux
$ PORT=4000 npm run dev
windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :
$ set PORT=4000 && npm run dev
windows 下使用 PowerShell 终端执行一下命令 :
$ $Env:PORT=4000; npm run dev
服务器启动默认 host 为 localhost,如果需要更改, 可使用以下命令 : Mac/Linux
$ HOST=127.0.0.1 npm run dev
windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :
$ set HOST=127.0.0.1 && npm run dev
免责声明
!> 1. 本项目仅供学习使用，请尊重版权，请勿利用此项目从事商业行为及非法用途!
!> 2. 使用本项目的过程中可能会产生版权数据。对于这些版权数据，本项目不拥有它们的所有权。为了避免侵权，使用者务必在 24 小时内清除使用本项目的过程中所产 生的版权数据。
!> 3. 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害（包括但不限于因商誉损失、停 工、计算机故障或故障引起的损害赔偿，或任何及所有其他商业损害或损失）由使用者负责。
!> 4. 禁止在违反当地法律法规的情况下使用本项目。 对于使用者在明知或不知当地法律法规不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担， 本项目不承担由此造成的任何直接、间接、特殊、偶然或结果性责任。
!> 5. 音乐平台不易，请尊重版权，支持正版。
!> 6. 本项目仅用于对技术可行性的探索及研究，不接受任何商业（包括但不限于广告等）合作及捐赠。
!> 7. 如果官方音乐平台觉得本项目不妥，可联系本项目更改或移除。
Vercel 部署
操作方法
- fork 此项目
- 在 Vercel 官网点击
New Project - 点击
Import Git Repository并选择你 fork 的此项目并点击import - 点击
PERSONAL ACCOUNT的select - 直接点
Continue - 若需要部署版本为概念版（不需要该步骤可以跳过），在
Environment Variables添加key为platform，Value (Will Be Encrypted)为lite然后点击Add PROJECT NAME自己填,FRAMEWORK PRESET选Other然后直接点Deploy接着等部署完成即可
接口文档
调用前须知
!> 本项目不提供线上 demo，请不要轻易信任使用他人提供的公开服务，以免发生安全问题,泄露自己的账号和密码
!> 为使用方便,降低门槛, 文档示例接口直接使用了 GET 请求,本项目同时支持 GET/POST 请按实际需求使用 (POST 请求 url 必须添加时间戳,使每次请求 url 不一样, 不然请求会被缓存)
!> 由于接口做了缓存处理 ( 缓存 2 分钟,), 相同的 url 会在两分钟内只向酷狗服务器发一次请求 , 如果遇到不需要缓 存结果的接口 , 可在请求 url 后面加一个时间 戳参数使 url 不同 , 例子 : /personal/fm?timestamp=1691256061923 (请按自己需求改造缓存中间件(app.js)，源码不复杂) 该缓存机制来源 于Binaryify/NeteaseCloudMusicApi
!> 不要频繁调登录接口,不然可能会被风控,登录状态还存在就不要重复调登录接口
!> 如果是跨域请求 , 请在所有请求带上 xhrFields: { withCredentials: true } (axios 为 withCredentials: true, Fetch API 为 fetch(url, { credentials: 'include' })), 或直接手动传入 cookie。
!> 本项目仅供学习使用,请尊重版权，请勿利用此项目从事商业行为或进行破坏版权行为
!> 文档可能会有缓存 , 如果文档版本和 github 上的版本不一致,请清除缓存再查看
更新记录
26-08-01：添加 上传音乐到云盘、删除用户云盘音乐 接口
26-05-20：更新曲谱相关接口
25-08-17: 手机登录添加支持多用户登录
25-04-05: 添加 用户云盘，用户云盘 url, 获取用户收藏视频，获取用户喜欢视频 等接口
25-03-28：添加 领取一天 VIP, 获取当月已领取 VIP 天数, 领取一天 VIP,获取已领取 VIP 状态,获取音乐 URL（新版） 等接口
25-03-07：更新单曲搜索接口，更新歌词搜索接口。
25-01-16：添加 获取继续播放信息 接口，修复部分老歌在概念版无法获取问题
25-01-11：添加 关注歌手 取消关注歌手 获取关注歌手新歌 接口
24-08-09：添加 获取更多音乐版本 接口。
24-07-22：添加 歌曲详情 接口.
24-07-17: 添加 搜索建议 接口。
24-07-14: 添加 频道、听书等多个接口。
24-07-14: 添加 刷刷、AI 推荐 接口，更新 提交听歌历史 接口。
24-06-30: 添加 获取歌手列表 接口
24-06-25: 添加 默认搜索关键词、获取歌曲 MV、提交听歌历史等接口
24-05-30: 添加曲谱接口
24-05-19: 修复设备平台判断问题，添加 获取用户关注歌手 接口
24-05-14: 添加 楼层评论、歌单评论、专辑评论、热搜列表接口。修复 歌单 接口
24-05-14: 添加 歌曲评论、歌曲评论-根据分类返回、歌曲评论-根据热词返回 接口
24-05-12: 添加支持酷狗概念版登录
24-05-07: 修复热门歌单接口
24-01-17: 添加：排行榜列表接口、排行榜推荐列表接口、排行榜往期列表接口、排行榜信息接口、排行榜歌曲列表接口
24-01-12: 更新私人 FM 接口
24-01-07: 添加 每日推荐、历史推荐、 风格推荐 API 接口
23-12-19: 添加场景音乐相关接口
23-12-18: 添加 收藏歌单，取消收藏歌单，对歌单添加歌曲，对歌单删除歌曲 接口
23-11-10: 添加歌手相关 API、添加视频相关 API
23-10-01: 添加领取 vip 接口
23-08-27: 更新音乐 url 获取
23-08-11: 添加电台 api
23-08-06: 添加缓存机制
23-07-19: 更新酷狗二维码登录
23-06-29: 添加 新歌速递、乐库等多个接口
23-06-28: 添加获取歌手图片接口
23-06-25: 添加 每日主题音乐 获取每日主题音乐详情 歌单 等接口
23-06-23: 修复搜索接口
23-06-23: 添加 搜索、获取歌词等接口
23-06-23: 添加 获取音乐 URL 接口
23-06-23: 更新文档
23-06-23: 添加每日歌曲推荐、专辑详情、专辑音乐列表、新碟上架
23-06-22: 添加支持微信登录、开放接口登录
23-06-22: 添加支持 vercel
23-06-22: 密码登录、验证码登录、扫码登录
登录
说明：登录有五个接口使用 encodeURIComponent对密码编码或者使用 POST请求，避免某些特殊字符无法解析,如#(#在 url 中会被识别为 hash,而不是 query)
不要频繁调登录接口,不然可能会被风控,登录状态还存在就不要重复调登录接口, 不同版本的 token 是不通用的
1.手机登录
必选参数：
mobile: 手机号码
code: 验证码，使用 /captcha/sent接口传入手机号获取验证码,调用此接口传入验证码,可使用验证码登录
可选参数
userid: 用户 id,当用户存在多个账户是时，必须加上需要登录的用户 id
接口地址： /login/cellphone
调用例子： /login/cellphone?mobile=xxx&code=xxx
2. 用户名登录(该登录可能需要验证，不推荐使用)
必选参数：
username: 用户名
password: 密码
接口地址： /login
调用例子： /login?username=xxx&password=yyy
3. 开放接口登录(目前仅支持微信登录)
说明: 该接口为第三方平台登录，目前仅支持微信登录
必选参数：
code: 由微信扫码成功后生成
接口地址： /login/openplat
调用例子： /login/openplat?code=xxx
4. 二维码登录
说明: 二维码登录涉及到 3 个接口,调用务必带上时间戳,防止缓存
1.二维码 key 生成接口
说明: 调用此接口可生成一个 key
接口地址： /login/qr/key
2.二维码生成接口
说明: 调用此接口传入上一个接口生成的 key 可生成二维码图片的 base64 和二维码信息,可使用 base64 展示图片,或者使用二维码信息内容自行使用第三方二维码生成 库渲染二维码
必选参数：
key: ,由第一个接口生成
可选参数：
qrimg: 传入后会额外返回二维码图片 base64 编码
接口地址： /login/qr/create
调用例子： /login/qr/create?key=xxx
2.二维码检测扫码状态接口
说明: 轮询此接口可获取二维码扫码状态,0 为二维码过期，1 为等待扫码，2 为待确认，4 为授权登录成功（4 状态码下会返回 token）
必选参数：
key: ,由第一个接口生成
接口地址： /login/qr/check
调用例子： /login/qr/check?key=xxx
5. 微信登录
说明：微信登录涉及到 2 个接口,调用务必带上时间戳,防止缓存
1. 二维码生成接口
说明：调用此接口可生成微信的 uuid, 包括二维码 Bae64 和 二维码扫描链接, 注: 该接口请求的接口过多, 会出现返回较慢的情况
接口地址： /login/wx/create
调用例子： /login/wx/create
2.二维码检测扫码状态接口
说明：轮询此接口可获取二维码扫码状态, 408 为等待扫描，404 为已经扫描，403 为拒绝登录，405 为登录成功，402 为已过期(405 状态下登陆完成口会返回 wx_code,
用于开放登陆 /login/openplat), 注：该接口有一定延时，不可访问是可以直接到
https://long.open.weixin.qq.com/connect/l/qrconnect?f=json&uuid=xxx 该接口直接请求
必选参数：
uuid: 由第一个接口生成
可选参数：
timestamp: 建议传递，否则由于缓存会导致延迟
接口地址： /login/wx/check
调用例子： /login/wx/check?timestamp=1691256061923&uuid=xxxxxxxxx
刷新登录
说明 : 调用此接口，可刷新登录状态，可以延长 token 过期时间
可选参数：
token: 登录后获取的 token
userid: 用户 id
接口地址： /login/token
调用例子： /login/token /login/token?token=xxx&userid=xxx
发送验证码
说明: 调用此接口 ,传入手机号码, 可发送验证码
必选参数：
mobile: 手机号码
接口地址： /captcha/sent
调用例子： /captcha/sent?mobile=xxx
dfid 获取
接口地址： /register/dev
调用例子： /register/dev
获取用户额外信息
说明：登陆后调用此接口，可以获取用户额外信息
接口地址： /user/detail
获取用户 vip 信息
说明：登陆后调用此接口，可以获取用户 vip 信息
接口地址： /user/vip/detail
获取用户歌单
说明：登录后调用此接口，可以获取用户的所有创建以及收藏的歌单
可选参数：
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /user/playlist
调用例子： /user/playlist
获取用户关注歌手
说明：登录后调用此接口，可以获取用户的所有关注的歌手/用户
接口地址： /user/follow
调用例子： /user/follow
获取关注歌手消息
说明：登录后调用此接口，可以关注的歌手/用户消息
id: 需要获取歌手/用户消息的 userid
pagesize : 每页页数, 默认为 30
接口地址： /user/follow/message
调用例子： /user/follow/message
获取用户云盘
说明：登录后调用此接口可以获取用户上传到云盘的音乐（需要登录）
可选参数
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /user/cloud
调用例子： /user/cloud
获取用户云盘音乐 URL
说明：登录后调用此接口可以获取用户上传到云盘的音乐 URL，部分可以直接用 /song/url 直接获取 URL（需要登录，目前获取到的文件大小都约为 10M 左右）
必选参数：
hash: 音乐 hash
可选参数：
album_id: 专辑 id
name: 云盘音乐名称
album_audio_id：专辑音频 id
接口地址： /user/cloud/url
调用例子： /user/cloud/url
删除用户云盘音乐
说明：登录后调用此接口可以删除用户云盘中的音乐（需要登录）
必选参数：
fileid: 云盘文件 ID（列表接口返回的 kv_id），多个可用逗号分隔；也可使用 fileids 传数组
可选参数：
clientver: 覆盖客户端版本号，默认使用当前平台配置
appid: 覆盖 appid，默认使用当前平台配置
kv_id: fileid 别名
album_audio_id: 专辑音频 ID（列表接口返回的 album_audio_id），多个可用逗号分隔；也可使用 album_audio_ids 传数组
接口地址： /user/cloud/del
调用例子： /user/cloud/del?fileid=1&album_audio_id=123
云盘上传前曲库匹配
说明：登录后调用此接口可以根据文件 hash 匹配曲库信息，用于上传前获取 hash_std、audio_id、album_audio_id
必选参数：
hash: 文件 hash（即文件 MD5），多个可用逗号分隔；也可通过请求体传入文件二进制数据自动计算
可选参数：
album_audio_id: 专辑音频 ID，已有时可辅助匹配，多个可用逗号分隔；也可使用 album_audio_ids 传数组
clientver: 覆盖客户端版本号，默认使用当前平台配置
appid: 覆盖 appid，默认使用当前平台配置
接口地址： /user/cloud/match
调用例子： /user/cloud/match?hash=e1fe087ba28766b8c95239487a0e46dc
上传音乐到云盘
说明：登录后调用此接口可以将音乐文件上传到用户云盘，需通过请求体传入文件二进制数据（Content-Type: application/octet-stream）
默认会先根据文件 hash 调用曲库匹配接口，并将匹配到的 hash_std、audio_id、album_audio_id 写入云盘；手动传入这些参数时会优先使用手动值
必选参数：
无
可选参数：
filename: 文件 hash（即文件 MD5），默认自动计算
extendname: 文件扩展名，默认为 mp3（自动去掉点号）
name: 云盘音乐显示名称，默认格式为 歌手名 - MD5.扩展名
author_name: 歌手名
hash_std: 曲库标准 hash，默认自动匹配
audio_id: 音频 id，默认为 0
album_audio_id: 专辑音频 id，默认为 0
auto_match: 是否自动匹配曲库，默认 1；传 0、false 或 no 可关闭
接口地址： /user/cloud/upload
调用例子： /user/cloud/upload
获取用户收藏的视频
说明：登录后调用此接口可以获取用户收藏的视频（需要登录）
可选参数
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /user/video/collect
调用例子： /user/video/collect
获取用户喜欢的视频
说明：登录后调用此接口可以获取用户喜欢的视频（需要登录）
可选参数
pagesize : 每页页数, 默认为 30
接口地址： /user/video/love
调用例子： /user/video/love
获取用户听歌历史排行
说明：登录后调用此接口，可以获取用户听歌历史排行
可选参数：
type：0 为获取最近一周前 120 首歌曲，1：获取全部累计前 120 首歌曲
接口地址： /user/listen
调用例子： /user/listen
获取用户最近听歌历史
说明：登录后调用此接口，可以近期的听歌历史记录(需要登陆)
可选参数：
bp: 可以更加上一次返回值传入
接口地址： /user/history
调用例子： /user/history
获取继续播放信息（对应手机版首页显示继续播放入口）
说明：登录后调用此接口，可以最后设备播放信息(需要登陆)
可选参数：
pagesize: 每页页数, 默认为 30
接口地址： /lastest/songs/listen
调用例子： /lastest/songs/listen
收藏歌单/新建歌单
说明 : 调用此接口, 可收藏歌单/新建歌单( 需要登录 ), 收藏成功后建议使用 /playlist/tracks/add 把原歌单下的歌曲添加到新的歌单
必选参数：
name: 歌单名称
list_create_userid: 歌单 list_create_userid
list_create_listid: 歌单 list_create_listid
可选参数
is_pri: 是否设为隐私，0：公开，1：隐私，仅支持创建歌单时传入
type: 1：为收藏歌单，0：创建歌单, 默认为 0
list_create_gid：歌单 list_create_gid
接口地址： /playlist/add
调用例子： /playlist/add?source=1&name=音乐一响%20纯爱登场.&list_create_userid=1782943844&list_create_listid=87
取消收藏歌单/删除歌单
说明 : 调用此接口 , 取消收藏歌单( 需要登录 )
必选参数：
listid: 用户歌单 listid
接口地址： /playlist/del
接口地址： /playlist/del?listid=xxx
对歌单添加歌曲
说明 : 调用此接口 , 可以添加歌曲到歌单 ( 需要登录 )
必选参数：
listid: 用户歌单 listid
data: 歌曲数据, 格式为 歌曲名称|歌曲 hash|专辑 id|(mixsongid/album_audio_id)，最少需要 歌曲名称以及歌曲 hash(若返回错误则需要全部参数)， 支持多个，每 个以逗号分隔
接口地址： /playlist/tracks/add
调用例子： /playlist/tracks/add?listid=1&data=我们应该算爱过吧|8E10D8825DDE03BCABBDE13E5A4150D2
/playlist/tracks/add?listid=1&data=我们应该算爱过吧|8E10D8825DDE03BCABBDE13E5A4150D2|67026620|477417208
/playlist/tracks/add?listid=1&data=我们应该算爱过吧|8E10D8825DDE03BCABBDE13E5A4150D2,我们应该算爱过吧|5015FC3FAB5B0C245556A1CC3C4DE355
对歌单删除歌曲
说明 : 调用此接口 , 可以删除歌单某首歌曲 ( 需要登录 )
必选参数：
listid: 用户歌单 listid
fileids: 歌单中歌曲的 fileid，可多个,用逗号隔开
接口地址： /playlist/tracks/del
调用例子： /playlist/tracks/del?listid=1&fileids=xx /playlist/tracks/del?listid=1&fileids=xx,xx
新碟上架
说明: 调用此接口 , 可获取新碟上架列表, 如需要专辑详细信息需要调用album/detail, 如需要获取专辑音乐列表需调
用album/songs
可选参数：
type : 1：华语；2：欧美；3：日本；4：韩国；推荐为空，默认为空
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /top/album
调用例子： /top/album
专辑信息
说明: 调用此接口 ,传入专辑 id 可获取专辑相关信息
必选参数：
album_id: 专辑 id,可以传多个，以逗号分割
可选参数：
fields: 需要返回的信息，可以传多个，以逗号分割，支持的值有 trans_param special_tag authors album_name publish_date cover intro
publish_company type album_id language_id is_publish heat grade quality exclusive grade_count author_name sizable_cover
language category
接口地址： /album
调用例子： /album?album_id=xxx, /album?album_id=xxx,xxx, /album?album_id=xxx&fields=language,authors
专辑详情
说明: 调用此接口 ,传入专辑 id 可获取专辑详情
必选参数：
id: 专辑 id
接口地址： /album/detail
调用例子： /album/detail?id=10729818
专辑音乐列表
说明: 调用此接口 ,传入专辑 id 可获取专辑音乐列表
必选参数：
id: 专辑 id
可选参数：
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /album/songs
调用例子： /album/songs?id=10729818
获取音乐 URL
说明: 调用此接口, 传入的音乐 hash, 可以获取对应的音乐的 url, 未登录状态或者非会员可能会返回为空。
⚠️ 注意：因接口问题，目前获取 url 接口数据需要先调用 /register/dev 接口获取 dfid，否则会提示 本次请求需要验证
必选参数：
hash: 音乐 hash
可选参数：
album_id: 专辑 id
free_part: 是否返回试听部分（仅部分歌曲）
album_audio_id：专辑音频 id
quality：获取不同音质的 url
quality 支持的参数
piano：对应手机端魔法音乐 钢琴，仅部分音乐支持
acappella：对应手机端魔法音乐 人声 伴奏，仅部分音乐支持，该模式下返回的音频后缀为 mkv 格式，该文加存在 人声 和 伴奏 两个音轨
subwoofer：对应手机端魔法音乐 骨笛，仅部分音乐支持
ancient：对应手机端魔法音乐 尤克里里，仅部分音乐支持
surnay：对应手机端魔法音乐 唢呐，仅部分音乐支持
dj：对应手机端魔法音乐 DJ，仅部分音乐支持
128：返回 128 码率 mp3 格式
320：返回 320 码率 mp3 格式
flac：返回 flac 格式音频
high：返回无损格式音频
viper_atmos：蝰蛇全景声，仅部分音乐支持
viper_clear：蝰蛇超清音质
viper_tape：蝰蛇母带，仅部分音乐支持, 该音质需要转码，关于转码相关的技术还不会
super：返回 DSD 格式音频，支持的音频少的可伶
接口地址： /song/url
调用例子： /song/url?hash=xxx
获取音乐 URL（新版）
说明: 调用此接口, 传入的音乐 hash, 可以获取对应的音乐的 url, 未登录状态或者非会员可能会返回为空，该接口会一次性返回支持的音质的音频 url, 但该接口存 在音频加密（目前无法解码），请谨慎使用
⚠️ 注意：因接口问题，目前获取 url 接口数据需要先调用 /register/dev 接口获取 dfid，否则会提示 本次请求需要验证
必选参数：
hash: 音乐 hash
可选参数：
album_audio_id：专辑音频 id
free_part: 是否返回试听部分（仅部分歌曲）
album_audio_id：专辑音频 id
接口地址： /song/url/new
调用例子： /song/url/new?hash=xxx
获取歌曲高潮部分
说明: 调用此接口, 传入的音乐 hash, 可以获取对应的音乐的高潮时间
必选参数：
hash: 音乐 hash, 可以传多个，以逗号分割
接口地址： /song/climax
调用例子： /song/climax?hash=xxx
搜索
说明: 调用此接口 , 传入搜索关键词可以搜索该音乐 / mv / 歌单 / 歌词 / 专辑 / 歌手
必选参数：
keywords: 关键词
可选参数：
page : 页数
pagesize : 每页页数, 默认为 30
type: 搜索类型；默认为单曲，special：歌单，lyric：歌词，song：单曲，album：专辑，author：歌手，mv：mv
⚠️ 注意：因接口问题，获取搜索结果需要在 url 后添加cookie认证信息或者Set-cookie，否则会返回 error_code: 152
⚠️ 注意：建议请求在所有搜索接口时添加认证信息防止调用失败！
接口地址： /search
调用例子： /search?keywords=海阔天空（错误示例），/search?keywords=周杰伦&cookie=token=xxxx;userid=xxxx;dfid=xxxx（必须携带认证信息）
默认搜索关键词
说明 : 调用此接口 , 可获取默认搜索关键词
接口地址： /search/default
综合搜索
说明: 调用此接口, 传入搜索关键词可以获得综合搜索，搜索结果同时包含单曲 , 歌手 , 歌单等信息
必选参数：
keywords: 关键词
可选参数：
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /search/complex
调用例子： /search/complex?keywords=海阔天空
热搜列表
说明 : 调用此接口,可获取热门搜索列表
接口地址： /search/hot
调用例子： /search/hot
搜索建议
说明 : 调用此接口 , 传入搜索关键词可获得搜索建议 , 搜索结果同时包含单曲 , 歌手 , 歌单信息
可选参数：
albumTipCount : 专辑返回数量
correctTipCount : 目前未知，可能是歌单
mvTipCount : MV 返回数量
musicTipCount : 音乐返回数量
接口地址： /search/suggest
调用例子： /search/suggest?keywords=海阔天空
歌词搜索
说明: 调用此接口, 可以搜索歌词，该接口需配合 /lyric 使用。
必选参数：
keywords: 关键词，与 hash 二选一
hash: 歌曲 hash，与 keyword 二选一
可选参数：
album_audio_id: 专辑音乐 id,
duration：歌曲时间
man: 是否返回多个歌词，yes：返回多个， no：返回一个。 默认为no
接口地址： /search/lyric
调用例子： /search/lyric?keywords=xxx /search/lyric?keywords=xxx&hash=xxx
获取歌词
说明 : 调用此接口，可以获取歌词，调用该接口前则需要调用/search/lyric 获取完整参数
必选参数：
id: 歌词 id, 可以从 /search/lyric 接口中获取
accesskey: 歌词 accesskey, 可以从 /search/lyric 接口中获取
可选参数：
fmt: 歌词类型，lrc 为普通歌词，krc 为逐字歌词
decode: 是否解码，传入该参数这返回解码后的歌词
接口地址： /lyric
调用例子： /lyric?id=xxx&accesskey=xxx /lyric?id=xxx&accesskey=xxx&fmt=lrc /lyric?id=xxx&accesskey=xxx&decode=true
歌单分类
说明 : 调用此接口,可获取歌单分类,包含 category 信息
接口地址： /playlist/tags
调用例子： /playlist/tags
歌单
说明 : 调用此接口 , 可获取歌单
必选参数：
category_id: tag，0：推荐，11292：HI-RES，其他可以从 /playlist/tags 接口中获取（接口下的 tag_id 为 category_id的值）
可选参数：
withsong: 是否返回歌曲列表（不全），0：不返回，1：返回
withtag: 是否返回歌单分类，0：不返回，1：返回
接口地址： /top/playlist
调用例子： /top/playlist?category_id=0
主题歌单
说明 : 调用此接口 , 可获取主题歌单, 通过 /theme/playlist/track 可以获取主题个单下的歌曲
接口地址： /theme/playlist
调用例子： /theme/playlist
音效歌单
说明 : 调用此接口 , 可获取音效歌单
可选参数：
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /playlist/effect
调用例子： /playlist/effect
获取歌单详情
说明: 调用此接口 , 可获取歌单详细信息
必选参数：
ids: 歌单中的 global_collection_id，可以传多个，用逗号分隔
接口地址： /playlist/detail
调用例子： /playlist/detail?ids=collection_3_1863870844_4_0 /playlist/detail?ids=collection_3_1863870844_4_0,collection_3_2093906551_8_0
获取歌单所有歌曲
说明 : 调用此接口，传入对应的歌单 global_collection_id，即可获得对应的所有歌曲
必选参数：
id: 歌单中的 global_collection_id
可选参数：
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /playlist/track/all
调用例子： /playlist/track/all?id=collection_3_1863870844_4_0
获取歌单所有歌曲(新版)
说明 : 调用此接口，传入对应的歌单 listid，即可获得对应的所有歌曲, 目前该接口仅支持 用户所创建及收藏的歌单
必选参数：
lisdid: 歌单中的 listid
可选参数：
page : 页数
pagesize : 每页页数, 默认为 30
接口地址： /playlist/track/all/new
调用例子： /playlist/track/all/new?listid=xxx
相似歌单
说明 : 调用此接口，根据歌单 id 获取相似歌单
必选参数：
ids：歌单 global_collection_id，支持多个，每个以逗号分隔
接口地址： /playlist/similar
调用例子： /playlist/similar?ids=collection_1_1341266283_964007_0
/playlist/similar?ids=collection_1_1341266283_964007_0,collection_3_1041185112_11_0
获取主题歌单所有歌曲
必选参数：
theme_id: 主题歌单 id
接口地址： /theme/playlist/track
调用例子： /theme/playlist/track?theme_id=18
获取主题音乐
说明 : 调用此接口，可以获取主题音乐，调用 /theme/music/detail 可以获取主题音乐详情
接口地址： /theme/music
调用例子： /theme/music
获取主题音乐详情
说明 : 调用此接口，传入对应的主题 id 可以获取主题音乐详情.
必选参数：
id: 主题音乐 id
接口地址： /theme/music/detail
调用例子： /theme/music/detail?id=1002
歌曲推荐
说明 : 调用此接口，可以获取歌曲推荐.
必选参数：
card_id: 1：对应安卓 精选好歌随心听 || 私人专属好歌，2：对应安卓 经典怀旧金曲，3：对应安卓 热门好歌精选，4：对应安卓 小众宝藏佳作，5：未知，6：对应
vip 专属推荐
接口地址： /top/card
调用例子： /top/card?card_id=1
歌曲推荐（概念版）
说明 : 调用此接口，可以获取歌曲推荐
必选参数：
card_id: 3006: VIP 专属推荐，3001: 私人专属好歌，3004: 小众宝藏佳作，3014: 喜欢这首歌的 TA 也喜欢，3101: 概念 er 新推，3005: 潮流尝鲜
可选参数
pagesize: 每页页数, 默认为 30
接口地址： /top/card
调用例子： /top/card/youth?card_id=3006
获取歌手和专辑图片
说明 : 调用此接口，可以获取歌手和专辑图片.
必选参数：
hash: 歌曲 hash, 可以传多个，每个以逗号分开
可选参数：
album_id: 专辑 id, 可以传多个，每个以逗号分开
album_audio_id: 专辑音乐 id, 可以传多个，每个以逗号分开
count: 最多返回多少张图片，默认为 5
接口地址： /images
调用例子： /images?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE
/image?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368&album_id=,75013431
获取歌手图片
说明 : 调用此接口，可以获取歌手图片.
必选参数：
hash: 歌曲 hash, 可以传多个，每个以逗号分开
可选参数：
audio_id: 音乐 id, 可以传多个，每个以逗号分开
album_audio_id: 专辑音乐 id, 可以传多个，每个以逗号分开
filename: 音乐文件名称, 可以传多个，每个以逗号分开
count: 最多返回多少张图片，默认为 5
接口地址： /images/audio
调用例子： /images/audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE
/image/audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368
获取音乐相关信息
说明：调用此接口，可以获取音乐相关信息
必选参数：
hash: 歌曲 hash, 可以传多个，每个以逗号分开
接口地址： /audio
调用例子： /audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE /audio?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368
获取更多音乐版本
说明：调用此接口，可以获取更多版本音乐
必选参数：
album_audio_id：音乐的 mixsongid/album_audio_id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
show_type：是否返回分类
sort：排序，支持 all，hot，new
type: 分类
show_detail：是否返回详情，否则只返回总数，0：只返回总数，不传或者其他都返回详情
接口地址： /audio/related
调用例子： /audio/related?album_audio_id=573120919 /audio/related?album_audio_id=573120919&show_detail=0
获取音乐伴奏信息
说明：调用此接口，可以获取最佳伴奏信息
必选参数：
hash：音乐 hash
fileName: 音乐 fileName
mixid: 音乐的 mixsongid/album_audio_id
接口地址： /audio/accompany/matching
调用例子： /audio/accompany/matching?fileName=希林娜依高 - Shine Brighter (愈加璀璨)&mixId=637735200&hash=6D431B0507587447B3D7345434DC5825
获取音乐 K 歌数量
说明：调用此接口，可以获取音乐 K 歌数量，参数信息均来自获取音乐伴奏信息
必选参数：
songId：音乐 songid, 该字段需要请求 获取音乐伴奏信息 获取
singerName：歌手名称，多个以 、 隔开，也可以到 获取音乐伴奏信息 中获取
songHash：音乐 hash, 该字段需要请求 获取音乐伴奏信息 获取
接口地址： /audio/ktv/total
调用例子： /audio/ktv/total?songId=43522508&singerName=希林娜依高&songHash=99AE5A7B04FF76550E380C3757D3E273
获取音乐详情
说明：调用此接口，可以获取音乐详情
必选参数：
hash: 歌曲 hash, 可以传多个，每个以逗号分开
接口地址： /privilege/lite
调用例子： /privilege/lite?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE
/privilege/lite?hash=B04ED0F01ABBB62B9D22EC4616ED8AFE,55603312694BF99AD6000C2D0D72D368
获取音乐专辑/歌手信息
说明：调用此接口，可以获取音乐专辑/歌手信息
必选参数：
album_audio_id: 专辑音乐 id (album_audio_id/MixSongID 均可以), 可以传多个，每个以逗号分开
可选参数
fields: 可以传 album_info authors.base base audio_info, authors.ip, extra, tags, tagmap 每个 field 以逗号分开
接口地址： /krm/audio
调用例子： /krm/audio?album_audio_id=32155307 /krm/audio?album_audio_id=32155307&fields=album_info,base,authors.base
私人 FM(对应手机和 pc 端的猜你喜欢)
说明 : 私人 FM
可选参数：
hash: 音乐 hash, 建议
songid: 音乐 songid, 建议
playtime: 已播放时间, 建议
mode: 获取模式，默认为 normal, normal：发现，small： 小众，peak：30s
action: 默认为 play, garbage: 为不喜欢
song_pool_id： 手机版的 AI，0：Alpha 根据口味推荐相似歌曲, 1：Beta 根据风格推荐相似歌曲, 2：Gamma
is_overplay: 是否已播放完成
remain_songcnt: 剩余未播放歌曲数, 默认为 0，大于 4 不返回推荐歌曲，建议
接口地址： /personal/fm
调用例子： /personal/fm
banner
说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据
接口地址： /pc/diantai
调用例子： /pc/diantai
乐库 banner
说明 : 调用此接口 , 可获取 乐库 banner( 轮播图 ) 数据
接口地址： /yueku/banner
调用例子： /yueku/banner
乐库电台
说明 : 调用此接口 , 可获取乐库电台数据
接口地址： /yueku/fm
调用例子： /yueku/fm
乐库
说明 : 调用此接口 , 可获取手机端乐库数据
接口地址： /yueku
调用例子： /yueku
电台
说明 : 调用此接口 , 可获取所有电台数据
接口地址： /fm/class
调用例子： /fm/class
电台 - 推荐
说明 : 调用此接口 , 可获取推荐电台
接口地址： /fm/recommend
调用例子： /fm/recommend
电台 - 图片
说明 : 调用此接口 , 可获取对应电台的图片
必选参数：
fmid: fmid，可以传多个，以逗号分割
接口地址： /fm/image
调用例子： /fm/image?fmid=693 /fm/image?fmid=693,37
电台 - 音乐列表
说明 : 调用此接口 , 可获取对应电台的音乐列表
必选参数：
fmid: fmid，可以传多个，以逗号分割
可选参数：
fmtype: fmtype, 可以传多个，以逗号分割
fmoffset: 歌曲偏移，可以传多个，以逗号分割
fmsize: 歌曲列表大小，可以传多个，以逗号分割
接口地址： /fm/songs
调用例子： /fm/image?fmid=693 /fm/image?fmid=693,37&fmtype=2,2&fmoffset=,5&fmsize5,3
编辑精选
说明 : 调用此接口 , 可获取编辑精选数据
接口地址： /top/ip
调用例子： /top/ip
编辑精选数据
说明 : 调用此接口 , 可获取编辑对应数据
必选参数：
id: ip id
可选参数：
type: 数据类型，audios: 音乐, albums: 专辑, videos: 视频, author_list: 歌手
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /ip
调用例子： /ip?id=87473 ip?id=87473&type=author_list
编辑精选歌单
说明：调用此接口，可获取编辑精选歌单数据
必选参数：
id: ip id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /ip/playlist
调用例子： /ip/playlist?id=87473
编辑精选专区
说明：调用此接口，可获取编辑精选专区相关内容，若数据中没有 ip_id，可使用/ip/zone/home来获取数据
接口地址： /ip/zone
调用例子： /ip/zone
编辑精选专区详情
说明：调用此接口，可获取编辑精选专区详情，若/ip/zone 数据中没有 ip_id，可使用该接口获取数据
必选参数：
id: ip id
接口地址： /ip/zone/home
调用例子： /ip/zone/home?id=329
领取 VIP（需要登陆，该接口为测试接口,仅限概念版使用，该接口目前不可使用）
说明 : 调用此接口 , 每天可领取 1 天 VIP 时长，需要领取 8 次，每次增加 3 小时，该接口来自 KG 概念版，非会员用户需要自行测试是否可用(尽量别频繁调用)
接口地址： /youth/vip
调用例子： /youth/vip
领取一天 VIP（需要登陆，该接口为测试接口,仅限概念版使用）
说明 : 调用此接口 , 领取概念版 VIP，传入日期可领取改日期一天 VIP，该接口来自 KG 概念版，非会员用户需要自行测试是否可用(尽量别频繁调用)
注意 ⚠️：建议不要领太多天
必选参数：
receive_day: 领取 VIP 日期，格式为：2026-01-30
接口地址： /youth/day/vip
调用例子： /youth/day/vip
升级概念版 VIP（需要登录，需要先领取一天 VIP，该接口为测试接口,仅限概念版使用）
说明 : 调用此接口 , 可以升级成畅听 VIP，该接口需要先领取一天 VIP（/youth/day/vip），该接口来自 KG 概念版，非会员用户需要自行测试是否可用(尽量别频繁
调用)
接口地址： /youth/day/vip/upgrade
调用例子： /youth/day/vip/upgrade
获取当月已领取 VIP 天数（需要登陆，该接口为测试接口,仅限概念版使用）
说明 : 调用此接口 ,获取当月已领取 VIP 天数
接口地址： /youth/month/vip/record
调用例子： /youth/month/vip/record
获取已领取 VIP 状态（需要登陆，该接口为测试接口,仅限概念版使用）
说明 : 调用此接口 ,获取已领取 VIP 状态
接口地址： /youth/union/vip
调用例子： /youth/union/vip
获取歌手列表
说明 : 调用此接口，可以获取歌手列表.
可选参数：
sextypes：性别类型，0：全部，1：男，2：女，3：组合
type：类型，0：全部，1：华语，2：欧美，3：日韩，4：其他，5：日本，6：韩国
musician：音乐人，3：为音乐人,0：默认
hotsize：返回热门数量，默认 30
接口地址： /artist/lists
调用例子： /artist/lists
获取歌手详情
说明 : 调用此接口 , 传入歌手 id, 可获得歌手信息
必选参数：
id： 歌手 id
接口地址： /artist/detail
调用例子： /artist/detail?id=6539
获取歌手专辑
说明 : 调用此接口 , 传入歌手 id, 可获得歌手专辑
必选参数：
id： 歌手 id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
sort: 排序，hot : 热门, new: 最新
接口地址： /artist/albums
调用例子： /artist/albums?id=6539
获取歌手单曲
说明 : 调用此接口 , 传入歌手 id, 可获得歌手歌曲
必选参数：
id： 歌手 id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
sort: 排序，hot : 热门, new: 最新
接口地址： /artist/audios
调用例子： /artist/audios?id=6539
获取歌手 MV
说明 : 调用此接口 , 传入歌手 id, 可获得歌手 MV
必选参数：
id： 歌手 id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
tag: official: 官方版本，live：现场版本，fan：饭制版本，artist: 歌手发布, all: 获取全部，默认为获取全部
接口地址： /artist/videos
调用例子： /artist/videos?id=6539
关注歌手
说明：调用此接口, 传入歌手 id, 可以关注该歌手（需要登录）
必选参数：
id: 歌手 id
接口地址： /artist/follow
调用例子： /artist/follow?id=6539
取消关注歌手
说明：调用此接口, 传入歌手 id, 可以取消关注该歌手（需要登录）
必选参数：
id: 歌手 id
接口地址： /artist/unfollow
调用例子： /artist/unfollow?id=6539
获取关注歌手新歌
说明：调用此接口, 可以获取用户已关注的歌手新歌（需要登录）
可选参数：
last_album_id: 最后专辑 id
pagesize: 每页页数, 默认为 30,
opt_sort: 排序，1：时间，2：亲密度，默认为 1(时间)
接口地址： /artist/follow/newsongs
调用例子： /artist/follow/newsongs
获取视频 url
说明 : 传入的视频的 hash, 可以获取对应的视频的 url
必选参数：
hash: 视频 hash
接口地址： /video/url
调用例子： /video/url?hash=3B5EE16299F703AEB0E5C28CB152EDF0
获取歌曲 MV
说明 : 传入 album_audio_id/MixSongID 获取歌曲 相对应的 mv
必选参数：
album_audio_id: 专辑音乐 id (album_audio_id/MixSongID 均可以), 可以传多个，每个以逗号分开,
可选参数：
fields: 支持多个，每个以逗号分隔，支持的值有：mkv,tags,h264,h265,authors
接口地址： /kmr/audio/mv
调用例子： /kmr/audio/mv?album_audio_id=32155307 /kmr/audio/mv?album_audio_id=32155307&fields=mkv,tags
获取视频相关信息
说明 : 传入的视频的 hash, 可以获取对应的视频的相关信息
必选参数：
hash: 视频 hash，可以传多个，以逗号隔开
接口地址： /video/privilege
调用例子： /video/privilege?hash=3B5EE16299F703AEB0E5C28CB152EDF0
获取视频详情
说明：调用此接口，可以获取视频详情，可以获取更高清的视频 hash
必选参数：
id: 视频 id/video id
接口地址： /video/detail
调用例子： /video/detail?id=11517822
新歌速递
说明：调用此接口，可以获取新歌速递
接口地址： /top/song
调用例子： /top/song
场景音乐列表
说明：调用此接口，可以场景音乐列表
接口地址： /scene/lists
调用例子： /scene/lists
场景音乐详情
说明：调用此接口，可以场景音乐详情
必选参数：
id: 场景音乐 scene_id
接口地址： /scene/module
调用例子： /scene/module?id=9
获取场景音乐讨论区
说明：调用此接口，可以获取场景音乐讨论区
必选参数
id: 场景音乐 scene_id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
sort: 排序，rec: 推荐，hot: 热门，new: 最新, 默认为推荐
接口地址： /scene/list/v2
调用例子： /scene/list/?id=9
获取场景音乐模块 Tag
说明：调用此接口，可以获取场景模块 Tag
必选参数
id: 场景音乐 scene_id
module_id: 场景音乐 module_id
可选参数：
接口地址： /scene/module/info
调用例子： /scene/module/info?id=9&module_id=83
获取场景音乐歌单列表
说明：调用此接口，可以获取场景音乐歌单列表
必选参数
tag_id: 场景音乐 tag_id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /scene/collection/list
调用例子： /scene/collection/list?tag_id=42391
获取场景音乐视频列表
说明：调用此接口，可以获取场景音乐视频列表
必选参数
tag_id: 场景音乐视频 tag_id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /scene/video/list
调用例子： /scene/video/list?tag_id=42399
获取场景音乐音乐列表
说明：调用此接口，可以获取场景音乐音乐列表
必选参数
id: 场景音乐 scene_id
module_id: 场景音乐 module_id
tag: 场景音乐 tag_id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /scene/audio/list
调用例子： /scene/audio/list?id=9&module_id=173&tag=42391
每日推荐
说明：调用此接口，可以获取每日推荐列表
可选参数：
platform：设备类型，默认为 ios,支持 android 和 ios
接口地址： /everyday/recommend
调用例子： /everyday/recommend
历史推荐
说明：调用此接口，可以获取历史推荐
可选参数：
mode：当 mode 为 list 时，则返回历史推荐列表，当 mode 为 song 时则返回当前歌曲列表，支持参数为：list 和 song,
history_name: 当 mode 为 song 该参数为必选参数。
date: 当 mode 为 song 该参数为必选参数。
platform：设备类型，默认为 ios,支持 android 和 ios
接口地址： /everyday/history
调用例子： /everyday/history /everyday/history?mode=song&history_name=RT_336d5ebc5436534e61d16e63ddfca327_20240106&date=20240106
风格推荐
说明：调用此接口，可以获取风格推荐
可选参数：
platform：设备类型，默认为 ios,支持 android 和 ios
tagids：支持多个，每个以逗号分隔，该接口下可获取 tag 信息
接口地址： /everyday/style/recommend
调用例子： /everyday/style/recommend /everyday/style/recommend?tagids=S14,S15,S16
排行列表
说明：调用此接口，可以获取排行榜列表
可选参数：
withsong：是否返回歌曲（部分）
接口地址： /rank/list
调用例子： /rank/list
排行榜推荐列表
说明：调用此接口，可以获取排行榜推荐列表
接口地址： /rank/top
调用例子： /rank/top
排行榜往期列表
说明：调用此接口，可以获取排行榜往期列表
必选参数：
rankid：排行榜 id
可选参数：
rank_cid：排行榜 cid
接口地址： /rank/vol
调用例子： /rank/vol?rankid=8888
排行榜信息
说明：调用此接口，可以获取排行榜信息
必选参数：
rankid：排行榜 id
可选参数：
rank_cid：排行榜 cid
album_img：是否返回专辑图片，1：返回，0：不返回，默认返回
zone：排行榜 zone
接口地址： /rank/info
调用例子： /rank/info?rankid=8888
排行榜歌曲列表
说明：调用此接口，可以获排行榜歌曲列表
必选参数：
rankid：排行榜 id
可选参数：
rank_cid：若需要返回往期歌曲列表，则该参数为必填，否则默认返回最新一期，/rank/vol 返回值中，volid 则为该参数
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /rank/audio
调用例子： /rank/audio?rankid=8888 /rank/audio?rankid=8888&rank_cid=76442
歌曲收藏数
说明 : 调用此接口 , 传入音乐 mixsongids 参数 , 可获得该音乐的收藏数( 不需要登录 )
必选参数：
mixsongids：音乐 mixsongid，多个以逗号分隔
接口地址： /favorite/count
调用例子： /favorite/count?mixsongids=368015985,368015986 /favorite/count?mixsongids=368015985
歌曲评论数
说明 : 调用此接口 , 传入音乐 hash/special_id 参数 , 可获得该音乐的评论数( 不需要登录 )
必选参数：
hash：音乐 hash
special_id：为 评论下的 special_child_id 字段
接口地址： /comment/count
调用例子： /comment/count?hash=98eb07ad8eaf74bf56dece55518ad63e /comment/count?special_id=20505418
歌曲评论
说明 : 调用此接口 , 传入音乐 mixsongid 参数 , 可获得该音乐的所有评论 ( 不需要登录 )
必选参数：
mixsongid：音乐 mixsongid
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
show_classify： 是否返回分类列表，0 为不返回，1 为返回
show_hotword_list：是否返回热词，0 为不返回，1 为返回
接口地址： /comment/music
调用例子： /comment/music?mixsongid=302362878
歌曲评论-根据分类返回
说明 : 调用此接口 , 传入音乐 mixsongid 和 type_id 参数 , 可获得该音乐的分类评论 ( 不需要登录 )
必选参数：
mixsongid：音乐 mixsongid
type_id：分类 id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
sort：排序，1 为正序，2 为倒序
接口地址： /comment/music/classify
调用例子： /comment/music/classify?mixsongid=302362878&type_id=12
歌曲评论-根据热词返回
说明 : 调用此接口 , 传入音乐 mixsongid 和 hot_word 参数 , 可获得该音乐的热词评论 ( 不需要登录 )
必选参数：
mixsongid：音乐 mixsongid
hot_word：热词
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /comment/music/hotword
调用例子： /comment/music/hotword?mixsongid=302362878&hot_word=生活
楼层评论
说明 : 调用此接口 , 传入资源 special_id 和资源类型 tid 和资源 mixsongid 参数, 可获得该资源的歌曲楼层评论
必选参数：
special_id：为 评论下的 special_child_id 字段
mixsongid：为 歌曲的 mixsongid
tid：评论 id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
接口地址： /comment/floor
调用例子： /comment/floor?special_id=100285259&mixsongid=302362878&tid=678433417
歌单评论
说明 : 调用此接口 , 传入歌单 id 参数 , 可获得该歌单的所有评论 ( 不需要登录 )
必选参数：
id：歌单 global_collection_id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
show_classify： 是否返回分类列表，0 为不返回，1 为返回
show_hotword_list：是否返回热词，0 为不返回，1 为返回
接口地址： /comment/playlist
调用例子： /comment/playlist?id=collection_3_1373407643_366_0
专辑评论
说明 : 调用此接口 , 传入 专辑 id 参数 , 可获得该专辑的所有评论 ( 不需要登录 )
id：专辑 id
可选参数：
page： 页码
pagesize: 每页页数, 默认为 30
show_classify： 是否返回分类列表，0 为不返回，1 为返回
show_hotword_list：是否返回热词，0 为不返回，1 为返回
接口地址： /comment/album
调用例子： /comment/album?id=collection_3_1373407643_366_0
提交听歌历史
说明：提交听歌历史后，支持在其他设备上查看听歌历史
必选参数：
mxid： 专辑音乐 id (album_audio_id/MixSongID 均可以)
可选参数：
ot：当前时间戳, 秒级，不要传入毫秒级，否者会返回错误，或者从 获取服务器时间 中获取
pc: 当前播放次数，更新播放次数，当服务器的值大于传入值时，将维持服务最大值，否则更新
接口地址： /playhistory/upload
调用例子： /playhistory/upload?mxid=32155307
获取服务器时间
说明：获取服务器时间，返回服务器时间戳
接口地址： /server/now
调用例子： /server/now
刷刷
说明：获取刷刷视频
接口地址： /brush
调用例子： /brush
AI 推荐
说明：传入 album_audio_id/MixSongID 获取 AI 推荐歌曲
必选参数：
album_audio_id： 专辑音乐 id (album_audio_id/MixSongID 均可以), 可以传多个，每个以逗号分开,
接口地址： /ai/recommend
调用例子： /ai/recommend?album_audio_id=274565080 /ai/recommend?album_audio_id=274565080,68435124
曲谱 - 获取歌曲曲谱
说明 : 调用此接口，传入歌曲 album_audio_id/MixSongID 可获得该歌曲的曲谱，注意：需要自己解析，别问我，我也看不懂
必选参数：
album_audio_id：音乐的 mixsongid/album_audio_id
可选参数：
instruments：曲谱类型 默认为 1，1：吉他， 2：尤克里里，3：钢琴，4：简谱
level： 等级/难度 默认为 0， 吉他（1: 进阶, 2：基础，0：中级），尤克里里/钢琴（0：基础，1：进阶）,简谱（0：基础）
接口地址： /sheet/song
调用例子： /sheet/song?album_audio_id=68435136
曲谱 - 曲谱详情
说明 : 调用此接口，传入曲谱 opern_id 可获得该曲谱详情，注意：需要自己解析，别问我，我也看不懂
必选参数：
opern_id：曲谱 id,
接口地址： /sheet/detail
调用例子： /sheet/detail?id=68435136_1_0
曲谱 - 曲谱排行榜
说明 : 调用此接口，可以获取推荐排行榜
可选参数：
instruments：曲谱类型 默认为 1，1：吉他， 2：尤克里里，3：钢琴，4：简谱
level： 等级/难度 默认为 0， 吉他（1: 进阶, 2：基础，0：中级），尤克里里/钢琴（0：基础，1：进阶）,简谱（0：基础）
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /sheet/rank
调用例子： /sheet/rank
曲谱 - 曲谱广场
说明 : 调用此接口，可以获取推荐曲谱
可选参数：
instruments：曲谱类型 默认为 1，1：吉他， 2：尤克里里，3：钢琴，4：简谱
level： 等级/难度 默认为 0， 吉他（1: 进阶, 2：基础，0：中级），尤克里里/钢琴（0：基础，1：进阶）,简谱（0：基础）
page：页数
pagesize : 每页页数, 默认为 30
tagid: 标签, 通过 /sheet/tags 获取
接口地址： /sheet/explore
调用例子： /sheet/explore
曲谱 - 曲谱标签
说明 : 调用此接口，可以获取曲谱标签
接口地址： /sheet/tags
调用例子： /sheet/tags
频道 - 获取用户所有频道
说明：登录后调用此接口，可以获取用户所有订阅的频道
可选参数：
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /youth/channel/all
调用例子： /youth/channel/all
频道 - 详情
说明：调用此接口，传入 global_collection_id / channel_id 可以获取频道详情
必选参数：
global_collection_id：频道 id (global_collection_id / channel_id 均可以), 可以传多个，每个以逗号分开,
接口地址： /youth/channel/detail
调用例子： /youth/channel/detail?global_collection_id=11576464149
频道 - 频道安利
说明：调用此接口，传入 global_collection_id / channel_id 可以获取频道安利
必选参数：
global_collection_id：频道 id (global_collection_id / channel_id 均可以)
接口地址： /youth/channel/amway
调用例子： /youth/channel/amway?global_collection_id=11576464149
频道 - 相似频道
说明：调用此接口，传入 global_collection_id / channel_id 可以获取相似频道
必选参数：
channel_id：频道 id (global_collection_id / channel_id 均可以)
接口地址： /youth/channel/similar
调用例子： /youth/channel/similar?channel_id=11576464149
频道 - 订阅
说明：登录后调用此接口， 传入 global_collection_id / channel_id 可订阅频道
必选参数：
global_collection_id：频道 id (global_collection_id / channel_id 均可以)
可选参数：
t：1 为订阅，0 为取消订阅，不传默认为订阅
接口地址： /youth/channel/sub
调用例子： /youth/channel/sub?global_collection_id=11576464149 /youth/channel/sub?global_collection_id=11576464149&t=0
频道 - 音乐故事
说明：调用此接口，传入 global_collection_id / channel_id 可以获取音乐故事
必选参数：
global_collection_id：频道 id (global_collection_id / channel_id 均可以)
可选参数：
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /youth/channel/song
调用例子： /youth/channel/song?global_collection_id=11576464149
频道 - 音乐故事详情
说明：调用此接口，传入 global_collection_id / channel_id 和 fileid 可以获取音乐故事详情
必选参数：
global_collection_id：频道 id (global_collection_id / channel_id 均可以)
fileid: 音乐故事 fileid
接口地址： /youth/channel/song/detail
调用例子： /youth/channel/song/detail?global_collection_id=11576464149&fileid=1720958083456581
动态 - 最常访问
说明：登录后调用此接口，可以获取经常访问的频道和用户
接口地址： /youth/dynamic/recent
调用例子： /youth/dynamic/recent
获取用户公开的音乐
说明：调用此接口，可以获取用户公开的音乐
必选参数：
userid：用户 id
可选参数：
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /youth/user/song
调用例子： /youth/user/song?userid=1354894105
听书 - 每日推荐
可选参数：
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /longaudio/daily/recommend
调用例子： /longaudio/daily/recommend
听书 - 排行榜推荐
接口地址： /longaudio/rank/recommend
调用例子： /longaudio/rank/recommend
听书 - VIP 推荐
接口地址： /longaudio/vip/recommend
调用例子： /longaudio/vip/recommend
听书 - 每周推荐
接口地址： /longaudio/week/recommend
调用例子： /longaudio/week/recommend
听书 - 专辑详情
必选参数：
album_id: 专辑 id 可以传多个，每个以逗号分开,
接口地址： /longaudio/album/detail
调用例子： /longaudio/album/detail?album_id=56655759
听书 - 专辑音乐列表
必选参数：
album_id: 专辑 id 可以传多个
接口地址： /longaudio/album/audios
调用例子： /longaudio/album/audios?album_id=56655759
歌曲详情 - 歌曲成绩单
说明：调用此接口，可以获取歌曲详情里面的歌曲成绩单信息
必选参数：
album_audio_id： 专辑音乐 id (album_audio_id/MixSongID 均可以),
接口地址： /song/ranking
调用例子： /song/ranking?album_audio_id=32155307
歌曲详情 - 歌曲成绩单详情
说明：登陆后调用此接口，可以获取更详细的歌曲成绩单信息
必选参数：
album_audio_id： 专辑音乐 id (album_audio_id/MixSongID 均可以),
可选参数：
page：页数
pagesize : 每页页数, 默认为 30
接口地址： /song/ranking/filter
调用例子： /song/ranking/filter?album_audio_id=32155307
验证码 - 获取验证码格式
说明：碰到错误码 20028 时，可调用该接口获取验证码的格式。
必选参数：
eventid：当请求出现错误码为 20028 时，一般会返回
接口地址： /get/verify/info
调用例子： /get/verify/info?eventid=gz_tx_event_xxx
验证码 - 验证验证码格式
说明：通过验证码后通过该请求验证。（目前仅实现了腾讯验证码，其他的没碰到）
必选参数：
eventid：当请求出现错误码为 20028 时，一般会返回
v_type：/get/verify/info 下获取
verifycode：通过滑块验证码等获取
sid：通过 wasm 获取，具体可查看 public\login_captcha.html
edt：同上
接口地址： /verify/user/info
调用例子： /verify/user/info?eventid=gz_tx_event_xxx&v_type=xx&verifycode=xxx&sid=xxx&edt=xxx
听歌识曲
说明：调用此接口，传入 PCM 音频数据（application/octet-stream），可识别歌曲信息。该接口必须使用 POST 请求
必选参数：
data：PCM 音频二进制数据（16bit 采样，通过 POST body 以 application/octet-stream 格式传入）
接口地址： /audio/match
调用例子： 使用 POST 请求，Content-Type: application/octet-stream，body 为 PCM 二进制数据
// 前端示例
const res = await fetch('/audio/match', {
method: 'POST',
headers: { 'Content-Type': 'application/octet-stream' },
body: pcmArrayBuffer,
});
获取已购单曲
说明：登录后调用此接口，可以获取用户已购买的单曲列表，返回歌曲详情及音频信息（需要登录）
可选参数：
page：页数
pagesize：每页页数，默认为 50
接口地址： /user/purchased/songs
调用例子： /user/purchased/songs
获取已购专辑
说明：登录后调用此接口，可以获取用户已购买的专辑列表（需要登录）
可选参数：
page：页数
pagesize：每页页数，默认为 15
接口地址： /user/purchased/albums
调用例子： /user/purchased/albums