music-api音乐接口快速上手：四大平台播放地址一次打通

music-api音乐接口快速上手：四大平台播放地址一次打通

【免费下载链接】music-apiMusic API项目地址: https://gitcode.com/gh_mirrors/mu/music-api

凌晨一点，你的音乐应用眼看就要上线，产品经理却抛来一句"歌呢？"。回头一看，网易云接口刚报403，QQ音乐返回一堆加密字段，酷狗和酷我的认证方式又完全不同……是不是已经开始头大了？其实，你缺的不是技术，而是一个趁手的音乐播放地址获取工具。

music-api就是一个轻量级的 PHP 音乐接口，它用四个独立文件，把网易云、QQ音乐、酷狗、酷我四大平台的歌曲与 MV 播放地址解析全部封装好，你只需发一个请求，就能拿到能直接播放的直链，省掉与各平台反复周旋的苦力活。

它到底有哪些亮眼的地方？

• 🎵一文件一平台：netease.php、qq.php、kugou.php、kuwo.php各管一摊，坏一个不连累其他
• ⚡零依赖开箱即用：不需要数据库、不需要 Composer，扔进 PHP 环境就能跑
• 📦标准 JSON 返回：响应自带 CORS 头，前端 Ajax 拿来直接用
• 🎬不止歌曲：酷狗、酷我还支持 MV 解析，网易云能解析歌单、随机推荐热门歌

三步开始使用

先把项目拉下来：

git clone https://gitcode.com/gh_mirrors/mu/music-api

项目不需要安装依赖，最简单的方式就是在本目录起一个 PHP 内置服务器：

php -S 0.0.0.0:8000

之后按需引入对应文件即可，比如你只要网易云：

require 'netease.php';

所有解析入口都通过 GET 参数驱动，统一得就像同一位老师教的。

挑三个最有代表性的功能看看

1. 网易云歌单解析，一行命令听完整张榜单（netease.php）

带上歌单 ID 和type=random，就能随机返回歌单里的一首歌；不传 ID 默认解析"热歌榜"，榜单对应的 ID 在 netease.php 源码注释里都有现成的，比如新歌榜是3779629：

curl "http://localhost:8000/netease.php?type=random&id=3779629"

返回的song_url就是可直接播放的直链。注意：酷我的接口则用rid定位歌曲，调用方式略有不同，具体可看 kuwo.php 的case 'rid'。

2. 酷狗 MV 解析，视频直链也能拿（kugou.php）

把type换成mv，搜歌名就能返回 MV 的播放地址和封面图，适合给音乐站点补充视频板块：

curl "http://localhost:8000/kugou.php?type=mv&msg=海阔天空&n=1"

3. QQ 音乐搜索与试听（qq.php）

不传n时返回的是歌曲列表（含mid），传了n就返回对应序号的播放直链：

curl "http://localhost:8000/qq.php?msg=晴天&n=0"

核心逻辑都集中在 qq.php 的get_qq_song函数里，想做二次开发，从这里入手最省力。

新手最容易踩的两个坑

坑一：付费歌曲拿不到链接

版权歌曲是各平台的"高压线"，代码对此的处理是：QQ 音乐返回[付费歌曲]标记、酷狗返回提示文字、酷我返回null。所以前端一定要做好空值兜底，别让song_url为空时整个页面崩掉。

坑二：本地能通、服务器上不通

解析全靠 cURL 请求外网，务必确认运行环境装了php-curl扩展，且服务器能访问外网、没有把目标域名加进防火墙黑名单。验证方法很简单，先手动curl一下源码里那几个接口地址，能通再看业务代码。

常见问题速答

问：平台接口哪天又改了，这项目还能用吗？答：这类解析接口天然会随平台变动而失效，好在项目模块化，哪个平台挂了改哪个文件即可，其余三个完全不受影响，维护成本被压到最低。

问：可以把它接到自己的网站或小程序里吗？答：可以。返回的是标准 JSON 且带 CORS 头，服务端中转或前端直连都行，注意控制请求频率、做好缓存，别把自己 IP 玩进风控名单。

问：能拿到无损或高音质吗？答：当前接口默认返回的是平台给普通用户的播放源，音质由平台决定，不同平台标准不一，直接拿来自动播放没问题，别指望它当成高品质下载源。

现在就让它跑起来

如果你正在做音乐聚合站、个人听歌小工具，或是想研究各平台公开接口的解析思路，这个项目都是一份极佳的参考：代码量不大、注释清楚、结构好拆。从git clone到跑通第一首歌，用不了五分钟。工具的价值在于帮你把时间花在真正重要的事情上——剩下的播放体验怎么做，就看你的了。如果它帮你省了几个晚上的时间，不妨给作者点个 star，让这份便利传递下去。🚀

【免费下载链接】music-apiMusic API项目地址: https://gitcode.com/gh_mirrors/mu/music-api