NeteaseCloudMusicApiEnhanced入门指南449个网易云音乐API接口一个开源项目全讲透【免费下载链接】api-enhanced 网易云音乐 Node.js API Services (Half Refactor Enhanced) 全网最全的网易云音乐API接口项目地址: https://gitcode.com/gh_mirrors/ap/api-enhancedNeteaseCloudMusicApiEnhancedapi-enhanced是一个基于 Node.js 的网易云音乐 API 接口项目号称全网最全内置449 个接口从登录、搜索、歌曲播放地址到歌单、评论、云盘、排行榜全覆盖。本文将带你零基础上手三步跑起服务并讲透 449 个接口的调用方式与避坑要点。一、为什么选择这个网易云音乐API项目很多老牌网易云 API 项目已经停更而本项目持续复活并增强核心优势一眼看清特性说明449 个接口覆盖登录、歌曲、歌单、评论、MV、云盘、动态、VIP 等全部场景多种加密协议支持 weapi / eapi / linuxapi / xeapi / neapi 五套加密通道️解灰功能默认开启全局解灰灰色歌曲自动尝试解锁部署方式全本地 Node.js、Docker、Vercel、腾讯云 Serverless 均可可当库使用支持在 Node.js / TypeScript 项目中直接require调用文档完善提供在线文档每个接口都有参数说明和调用示例项目遵循 MIT License任何人都可以自由使用、修改和分发。二、三步快速部署本地跑起网易云音乐API服务1. 一键安装步骤环境要求Node.js 22 及以上推荐使用 pnpm 管理依赖。git clone https://gitcode.com/gh_mirrors/ap/api-enhanced cd api-enhanced pnpm i2. 启动服务# 默认端口 3000 node app.js # 或指定端口 PORT4000 node app.js # Mac/Linux set PORT4000 node app.js # Windows看到启动日志后浏览器访问http://localhost:3000即可打开内置接口文档随便点一个接口的例子就能看到真实返回数据。3. Docker 部署最快方式不想装 Node 环境一条命令搞定docker pull moefurina/ncm-api:latest docker run -d -p 3000:3000 --name ncm-api moefurina/ncm-api:latest 部署细节、环境变量如ENABLE_FLAC无损音质、ENABLE_GENERAL_UNBLOCK解灰开关的完整说明见 README.MD。三、449 个接口怎么调三种姿势全讲解姿势一HTTP 直接调用最常用项目同时支持 GET / POST 请求接口地址就是文件名。例如获取歌曲播放地址GET /song/url?id33894312每个接口对应 module/ 目录下的一个文件文件名即路由module/song_url.js→/song/urlmodule/album_new.js→/album/new。想看某个接口怎么实现的直接打开对应文件即可每个文件通常只有十来行例如 module/album_new.jsmodule.exports (query, request) { const data { limit: query.limit || 30, offset: query.offset || 0, area: query.area || ALL, } return request(/api/album/new, data, createOption(query, weapi)) }姿势二Node.js / TypeScript 代码调用不需要起服务也可以把整个项目当 SDK 用每个接口导出为同名函数返回 Promiseconst { login_cellphone, user_cloud } require(neteasecloudmusicapienhanced/api) const result await login_cellphone({ phone: 手机号, password: 密码 }) const cloud await user_cloud({ cookie: result.body.cookie })完整调用链路示例见 module_example/test.js登录 → 云盘 → 收藏专辑 → 歌曲地址一气呵成。TypeScript 项目则有完整类型提示interface.d.ts。姿势三命令行批量示例module_example/ 目录里还放着头像上传、歌曲上传等命令行演示脚本照着改参数就能用。四、高频接口速查表449 个接口看着多日常 80% 场景只需要记住这几个接口地址作用源码/login/cellphone手机号登录module/login_cellphone.js/login/qr/create二维码登录module/login_qr_create.js/search关键词搜索歌曲/歌单module/search.js/song/url获取歌曲播放地址module/song_url.js/playlist/detail歌单详情module/playlist_detail.js/comment/music歌曲评论module/comment_music.js/user/cloud我的云盘module/user_cloud.js/top/list排行榜module/top_list.js/captcha/sent发送短信验证码module/captcha_sent.js完整接口清单可在线文档或 public/docs/home.md 中逐一查看。五、调用前必知的 6 个避坑要点项目方把调用前须知做成了一张长图public/docs/aigen.png这里提炼最关键的几条有 2 分钟缓存相同 URL 两分钟内只会请求一次网易服务器防止 IP 高频报错。需要实时数据URL 后加时间戳/simi/playlist?id347230timestamp1503019930000。301 错误 没登录大部分接口需要 cookie登录接口会返回cookie字段后续请求带上即可也可直接从浏览器复制MUSIC_U值。别频繁调登录登录接口带加密流程且容易被风控登录状态还在就复用不要重复登录。跨域请求要带 cookieaxios 加withCredentials: true或手动传 cookie 参数。海外服务器被限制传realIP国内IP或加randomCNIPtrue自动生成随机中国 IP。支持代理query 中加proxyyour-proxy即可让单次请求走代理支持 PAC 文件。六、进阶玩法解密调试与二次开发解密调试访问/api_decrypt.html可解析 weapi / eapi / linuxapi / xeapi / neapi 五种加密协议的请求参数与返回内容调试加密细节时可传e_r1返回加密结果。单元测试pnpm test即可运行测试请求真实网易云 APItest/ 目录下有各接口测试用例。新增接口在 module/ 新建一个 JS 文件即可自动挂载路由文件名就是路由路径参考 AGENTS.md 中的架构说明。SDK 生态社区已有 Java、Python、Swift、Rust 等多语言 SDK 可直接调用。七、总结NeteaseCloudMusicApiEnhanced 是目前最活跃的网易云音乐 API 开源项目449 个接口、五种加密协议、解灰能力、全平台部署支持且每个接口的实现都薄到十几行代码新手读起来毫无压力。 三步走回顾clone → pnpm i → node app.js你的自建网易云音乐 API 服务就上线了。祝玩得开心【免费下载链接】api-enhanced 网易云音乐 Node.js API Services (Half Refactor Enhanced) 全网最全的网易云音乐API接口项目地址: https://gitcode.com/gh_mirrors/ap/api-enhanced创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考