---

---

计费模式

---

请求地址 HTTPGET

---

请求参数

---

参数名	参数说明
key	用户请求密钥，可在 密钥管理页面 申请
id	歌单的id，当type=songlist (解析歌单)时有效。
type	解析类型：song 单曲信息，songlist 歌单，so 搜索音乐，url 音乐试听链接，pic 专辑图，lrc 歌词，mv 音乐mv信息(包括下载链接)，topgroup 排行榜分组，toplist 排行榜歌曲列表
per_page	当type=so(搜索音乐)时有效，定义搜索结果数量，默认10
page	当type=so(搜索音乐)时，page可指定搜索的页数，需配合per_page参数使用。默认1
word	当type=so(搜索音乐)时有效，定义要搜索的关键词，必须进行urlencode编码。
mid	歌曲的mid，当type等于song、url、pic、lrc时有效。
size	定义歌曲音质，当type=url时有效，留空默认m4a试听音质，可选参数：mp3:普通音质、hq:高品质、sq:无损、hires:HiRes音质。
media_mid	歌曲media_mid，当type=url时有效，留空默认mid。此参数可留空。
format	如果此参数定义为json，且当type等于url、pic、lrc时输出json格式数据，留空默认302重定向到资源。
cookie	如果要下载付费音乐或VIP音乐请传绿钻cookie，在y.qq.com登录后抓包获取cookie的qm_keyst和uin即可。然后再把cookie进行base64加密。例如：cookie = base64_encode(qm_keyst=Q_H_L_5qeM59G2KVyfbkM; uin=523077333)
vid	当type=mv(音乐mv信息)时有效，MV的vid，可在音乐信息或搜索列表或歌单列表获取。
topid	当type=toplist(排行榜歌曲列表)时有效，通过排行榜分组得到topid
period	当type=toplist(排行榜歌曲列表)时有效，通过排行榜分组得到period

请求结果参数说明

---

参数名	参数说明
code	响应状态码，非200均为失败
msg	响应状态信息
data	请求返回的数据集
debug	附加数据，一般为缓存时间
exec_time	请求耗时，单位(秒)
user_ip	发起请求的客户端IP