@neteasecloudmusicapienhanced/api 4.30.1 → 4.30.3

package/public/docs/home.md

@@ -2,6 +2,8 @@
 
 网易云音乐 NodeJS API Enhanced
 
+最后更新于: 2026.2.15
+
 ## 灵感来自
 
 [disoul/electron-cloud-music](https://github.com/disoul/electron-cloud-music)
@@ -781,7 +783,7 @@ tags: 歌单标签
 **必选参数 :** `uid` : 用户 id
 
 **可选参数 :**
-`limit` : 返回数量 , 默认为 30
+`limit` : 返回数量 , 默认为 20
 
 `offset` : 偏移数量，用于分页 ,如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
 
@@ -1252,6 +1254,21 @@ tags: 歌单标签
 
 说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。
 
+### 302到音乐 url - 新版
+
+说明 : 只允许传入单个`id`，会使用302重定向请求到目标url
+
+**必选参数 :** `id` : 音乐 id
+`level`: 播放音质等级, 分为 `standard` => `标准`,`higher` => `较高`, `exhigh`=>`极高`,
+`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带`
+`unblock`: 是否使用使用歌曲解锁, 分为`true`和`false`
+
+**接口地址 :** `/song/url/v1/302`
+
+**调用例子 :** `/song/url/v1/302?id=1969519579&level=exhigh`
+
+说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。
+
 ### 音乐是否可用
 
 说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 `{ success: true, message: 'ok' }` 或者 `{ success: false, message: '亲爱的,暂无版权' }`
@@ -1684,6 +1701,62 @@ tags: 歌单标签
 
 **调用例子 :** `/comment/video?id=89ADDE33C0AAE8EC14B99F6750DB954D`
 
+### 评论统计数据
+
+说明 : 调用此接口 , 传入资源类型和资源 id 列表 , 可批量获取对应资源的评论统计数据 ( 不需要登录 )
+
+**必选参数 :**
+
+`type`: 数字 , 资源类型 , 对应以下类型
+
+```
+0: 歌曲
+
+1: mv
+
+2: 歌单
+
+3: 专辑
+
+4: 电台节目
+
+5: 视频
+
+6: 动态
+
+7: 电台
+```
+
+`ids`: 资源 id 列表 , 多个 id 用逗号分隔 , 如 `186016,347230`
+
+**接口地址 :** `/comment/info/list`
+
+**调用例子 :** `/comment/info/list?type=0&ids=186016,347230`
+
+**返回数据 :**
+
+```json
+{
+  "data": [
+    {
+      "latestLikedUsers": null,
+      "liked": false,
+      "comments": null,
+      "resourceType": 4,
+      "resourceId": 186016,
+      "commentUpgraded": false,
+      "musicianSaidCount": 0,
+      "commentCountDesc": "100w+",
+      "likedCount": 347,
+      "commentCount": 1970844,
+      "shareCount": 109721,
+      "threadId": "R_SO_4_186016"
+    }
+  ],
+  "code": 200
+}
+```
+
 ### 热门评论
 
 说明 : 调用此接口 , 传入 type, 资源 id 可获得对应资源热门评论 ( 不需要登录 )
@@ -2766,7 +2839,7 @@ type : 地区
 
 参考: https://github.com/neteasecloudmusicapienhanced/api-enhanced/blob/main/public/cloud.html
 
-访问地址: http://localhost:3000/cloud.html)
+访问地址: http://localhost:3000/cloud.html
 
 支持命令行调用,参考 module_example 目录下`song_upload.js`
 
@@ -2774,6 +2847,78 @@ type : 地区
 
 **调用例子 :** `/cloud`
 
+#### 上传模式说明
+
+云盘上传支持两种模式:
+
+**1. 后端代理模式 (默认)**
+
+文件通过服务器转发到云存储,调用简单,但受服务器限制:
+
+- Vercel Serverless Functions 限制请求体大小为 4.5MB
+- 自建服务器需配置足够大的请求体限制
+
+**2. 客户端直传模式 (推荐用于 Vercel)**
+
+文件直接从客户端上传到云存储服务器,绕过服务器限制:
+
+- 支持大文件上传
+- 适合 Vercel、Netlify 等有请求体限制的平台
+- 需要前端配合实现
+
+#### 客户端直传相关接口
+
+**获取上传凭证**
+
+**接口地址 :** `/cloud/upload/token`
+
+**必选参数 :**
+
+- `cookie`: 网易云音乐 Cookie (在请求体中传递)
+- `md5`: 文件 MD5 值
+- `fileSize`: 文件大小(字节)
+- `filename`: 文件名
+
+**返回数据 :**
+
+```json
+{
+  "code": 200,
+  "data": {
+    "needUpload": true,
+    "songId": "...",
+    "uploadToken": "...",
+    "uploadUrl": "...",
+    "resourceId": "..."
+  }
+}
+```
+
+**完成上传导入**
+
+**接口地址 :** `/cloud/upload/complete`
+
+**必选参数 :**
+
+- `cookie`: 网易云音乐 Cookie (在请求体中传递)
+- `songId`: 歌曲 ID
+- `resourceId`: 资源 ID
+- `md5`: 文件 MD5
+- `filename`: 文件名
+
+**可选参数 :**
+
+- `song`: 歌曲名
+- `artist`: 艺术家
+- `album`: 专辑名
+
+#### 客户端直传流程
+
+1. 客户端计算文件 MD5
+2. 调用 `/cloud/upload/token` 获取上传凭证
+3. 如果 `needUpload` 为 true,直接 PUT 文件到 `uploadUrl`
+4. 调用 `/cloud/upload/complete` 完成导入
+
 ### 云盘歌曲信息匹配纠正
 
 说明 : 登录后调用此接口,可对云盘歌曲信息匹配纠正,如需取消匹配,asid 需要传 0
@@ -2790,6 +2935,7 @@ type : 地区
 **调用例子 :** `/cloud/match?uid=32953014&sid=aaa&asid=bbb` `/cloud/match?uid=32953014&sid=bbb&asid=0`
 
 ### 获取云盘歌词
+
 说明: 调用此接口, 获取云盘歌曲的歌词，歌词来自此文件的音乐元数据`LYRICS`标签。
 
 **可选参数 :**
@@ -3972,13 +4118,15 @@ type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009`
 
 **接口地址:** `/voicelist/search`
 
-**可选参数：**
+**必选参数：**
 
-`limit`: 取出歌单数量 , 默认为 200
+`keyword`: 搜索关键词
 
-`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*200, 其中 200 为 limit 的值
+**可选参数：**
 
-`podcastName`: 播客名称
+`limit`: 取出歌单数量, 默认为 10
+
+`offset`: 偏移数量 , 用于分页 , 默认为 30
 
 ### 播客声音列表
 
@@ -4883,12 +5031,11 @@ let data = encodeURIComponent(
 
 **调用例子:** `/vip/sign/info`
 
-
 ### 用户的创建歌单列表
 
 说明 : 调用此接口, 传入用户id, 获取用户的创建歌单列表
 
-**必选参数 :**  
+**必选参数 :**
 
 `uid`: 用户 id
 
@@ -4906,7 +5053,7 @@ let data = encodeURIComponent(
 
 说明 : 调用此接口, 传入用户id, 获取用户的收藏歌单列表
 
-**必选参数 :**  
+**必选参数 :**
 
 `uid`: 用户 id
 
@@ -4920,6 +5067,82 @@ let data = encodeURIComponent(
 
 **调用例子 :** `/user/playlist/collect?uid=32953014`
 
+### 搜索建议 - PC端
+
+说明 : 调用此接口, 传入搜索关键词, 获取搜索建议
+
+**必选参数 :**
+
+`keyword`: 搜索关键词
+
+**接口地址 :** `/search/suggest/pc`
+
+**调用例子 :** `/search/suggest/pc?keyword=海阔天空`
+
+### 喜欢歌曲 - 新版
+
+说明 : 登录后调用此接口, 传入歌曲 id 用户id和喜欢状态, 可喜欢/取消喜欢歌曲
+
+**必选参数 :**
+
+`id`: 歌曲 id
+`uid`: 用户 id
+`like`: 喜欢状态, true 表示喜欢, false 表示取消喜欢
+
+**接口地址 :** `/song/like`
+
+**调用例子 :** `/song/like?id=2058263032&uid=32953014&like=true`
+
+### 我创建的播客声音
+
+说明 : 登录后调用此接口, 获取我创建的博客声音
+
+**可选参数 :** 
+
+`limit` : 返回数量 , 默认为 20
+
+**接口地址 :** `/voicelist/my/created`
+
+**调用例子 :** `/voicelist/my/created`
+
+### 发布评论
+
+说明 : 登录后调用此接口, 传入评论线程 id, 评论内容等信息, 发布评论
+
+**必选参数 :**
+
+`id`: 歌曲id
+`content`: 评论内容
+
+**接口地址 :** `/comment/add`
+
+**调用例子 :** `/comment/add?id=2058263032&content=这首歌太棒了！`
+
+### 删除评论
+
+说明 : 登录后调用此接口, 传入评论 id, 删除评论
+
+**必选参数 :**
+`cid`: 评论 id
+`id`: 歌曲id
+
+**接口地址 :** `/comment/delete`
+
+**调用例子 :** `/comment/delete?threadId=2058263032&commentId=123456789`
+
+### 回复评论
+
+说明 : 登录后调用此接口, 传入歌曲 id, 回复内容等信息, 回复评论
+
+**必选参数 :**
+`id`: 歌曲id
+`commentId`: 被回复的评论 id
+`content`: 回复内容
+
+**接口地址 :** `/comment/reply`
+
+**调用例子 :** `/comment/reply?id=2058263032&commentId=123456789&content=我也觉得这首歌很棒！`
+
 ## 离线访问此文档
 
 此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问

package/public/docs/index.html

@@ -5,7 +5,7 @@
   <meta name="KEYWords" contect="网易云音乐,网易云音乐 api,网易云音乐 nodejs,网易云音乐 node.js">
   <meta name="description" content="网易云音乐 NodeJS API Enhanced">
   <title>网易云音乐 NodeJS API Enhanced</title>
-  <link rel="icon" href="favicon.ico">
+  <link rel="icon" href="netease.png">
   <meta name="description" content="Description">
   <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
   <meta name="referrer" content="never">

package/public/docs/logo.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <g>
+        <path fill="none" d="M0 0h24v24H0z"/>
+        <path d="M10.421 11.375c-.294 1.028.012 2.064.784 2.653 1.061.81 2.565.3 2.874-.995.08-.337.103-.722.027-1.056-.23-1.001-.52-1.988-.792-2.996-1.33.154-2.543 1.172-2.893 2.394zm5.548-.287c.273 1.012.285 2.017-.127 3-1.128 2.69-4.721 3.14-6.573.826-1.302-1.627-1.28-3.961.06-5.734.78-1.032 1.804-1.707 3.048-2.054l.379-.104c-.084-.415-.188-.816-.243-1.224-.176-1.317.512-2.503 1.744-3.04 1.226-.535 2.708-.216 3.53.76.406.479.395 1.08-.025 1.464-.412.377-.996.346-1.435-.09-.247-.246-.51-.44-.877-.436-.525.006-.987.418-.945.937.037.468.173.93.3 1.386.022.078.216.135.338.153 1.334.197 2.504.731 3.472 1.676 2.558 2.493 2.861 6.531.672 9.44-1.529 2.032-3.61 3.168-6.127 3.409-4.621.44-8.664-2.53-9.7-7.058C2.515 10.255 4.84 5.831 8.795 4.25c.586-.234 1.143-.031 1.371.498.232.537-.019 1.086-.61 1.35-2.368 1.06-3.817 2.855-4.215 5.424-.533 3.433 1.656 6.776 5 7.72 2.723.77 5.658-.166 7.308-2.33 1.586-2.08 1.4-5.099-.427-6.873a3.979 3.979 0 0 0-1.823-1.013c.198.716.389 1.388.57 2.062z"/>
+    </g>
+</svg>

package/public/index.html

@@ -4,6 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <link rel="icon" href="docs/netease.png">
   <title>网易云音乐 API Enhanced</title>
   <style>
     :root {
@@ -18,20 +19,33 @@
     html, body { height: 100%; }
     body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: var(--fg); background: var(--bg); line-height: 1.6; }
     .container { max-width: 960px; margin: 40px auto; padding: 0 20px; }
+    @media (max-width: 480px) {
+      .container { margin: 20px auto; padding: 0 16px; }
+      header.site-header h1 { font-size: 22px; }
+      .block { padding: 16px; }
+    }
     header.site-header { margin-bottom: 24px; }
     header.site-header h1 { font-size: 28px; font-weight: 600; margin: 0; }
     .badge { display: inline-block; margin-left: 8px; padding: 4px 10px; border: 1px solid var(--border); border-radius: 12px; font-size: 12px; color: var(--muted); }
     .sub { margin-top: 8px; color: var(--muted); font-size: 14px; }
     .block { background: var(--panel); border: 1px solid var(--border); border-radius: 12px; padding: 20px; margin-bottom: 16px; box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05); }
     .block h2 { margin: 0 0 12px; font-size: 18px; font-weight: 600; }
-    .kvs { display: grid; grid-template-columns: 140px 1fr; gap: 8px 16px; align-items: center; }
-    .kvs div:first-child { color: var(--muted); }
+    .kvs { display: grid; grid-template-columns: 100px 1fr; gap: 8px 12px; align-items: start; }
+    .kvs div:first-child { color: var(--muted); flex-shrink: 0; }
+    .kvs div:last-child { word-break: break-all; overflow-wrap: anywhere; min-width: 0; overflow: hidden; }
+    @media (max-width: 480px) {
+      .kvs { grid-template-columns: 1fr; gap: 4px 12px; }
+      .kvs div:first-child { font-weight: 500; }
+    }
     ul.links { list-style: none; padding: 0; margin: 0; }
     ul.links li { margin: 8px 0; }
     ul.links a { color: var(--fg); text-decoration: none; border-bottom: 1px dotted var(--border); transition: all 0.2s ease; }
     ul.links a:hover { color: var(--accent); border-bottom-color: var(--accent); }
-    pre { margin: 0; background: #f9f9f9; border: 1px solid var(--border); border-radius: 6px; padding: 12px; overflow: auto; }
+    pre { margin: 0; background: #f9f9f9; border: 1px solid var(--border); border-radius: 6px; padding: 12px; overflow-x: auto; white-space: pre-wrap; word-break: break-all; }
     code { font-family: 'Courier New', monospace; font-size: 13px; }
+    @media (max-width: 480px) {
+      code { font-size: 12px; }
+    }
     footer.site-footer { margin-top: 24px; padding-top: 12px; border-top: 1px solid var(--border); color: var(--muted); text-align: center; }
     footer.site-footer a { color: var(--fg); text-decoration: none; transition: color 0.2s ease; }
     footer.site-footer a:hover { color: var(--accent); }
@@ -71,7 +85,18 @@
       <h2>调试部分</h2>
       <pre><code>curl -s {origin}/inner/version
 curl -s {origin}/search?keywords=网易云</code></pre>
-      <p style="margin-top:10px"> · <a href="/api.html">交互式调试</a> · <a href="/qrlogin.html">二维码登录示例</a> · <a href="/unblock_test.html">解灰测试</a></p> · <a href="/audio_match_demo/index.html">听歌识曲 Demo</a></p> · <a href="/cloud.html">云盘上传</a></p> · <a href="/playlist_import.html">歌单导入</a></p> · <a href="/eapi_decrypt.html">EAPI 解密</p> · <a href="/listen_together_host.html">一起听示例</p> · <a href="/playlist_cover_update.html">更新歌单封面示例</p> · <a href="/avatar_update.html">头像更新示例</p>
+      <div style="margin-top:10px; line-height:2;">
+        <a href="/api.html">交互式调试</a> ·
+        <a href="/qrlogin.html">二维码登录示例</a> ·
+        <a href="/unblock_test.html">解灰测试</a> ·
+        <a href="/audio_match_demo/index.html">听歌识曲 Demo</a> ·
+        <a href="/cloud.html">云盘上传</a> ·
+        <a href="/playlist_import.html">歌单导入</a> ·
+        <a href="/eapi_decrypt.html">EAPI 解密</a> ·
+        <a href="/listen_together_host.html">一起听示例</a> ·
+        <a href="/playlist_cover_update.html">更新歌单封面示例</a> ·
+        <a href="/avatar_update.html">头像更新示例</a>
+      </div>
     </section>
 
     <footer class="site-footer">

package/server.js

@@ -178,10 +178,25 @@ async function consturctServer(moduleDefs) {
   /**
    * Body Parser and File Upload
    */
-  app.use(express.json({ limit: '50mb' }))
-  app.use(express.urlencoded({ extended: false, limit: '50mb' }))
-
-  app.use(fileUpload())
+  const MAX_UPLOAD_SIZE_MB = 500
+  const MAX_UPLOAD_SIZE_BYTES = MAX_UPLOAD_SIZE_MB * 1024 * 1024
+
+  app.use(express.json({ limit: `${MAX_UPLOAD_SIZE_MB}mb` }))
+  app.use(
+    express.urlencoded({ extended: false, limit: `${MAX_UPLOAD_SIZE_MB}mb` }),
+  )
+
+  app.use(
+    fileUpload({
+      limits: {
+        fileSize: MAX_UPLOAD_SIZE_BYTES,
+      },
+      useTempFiles: true,
+      tempFileDir: require('os').tmpdir(),
+      abortOnLimit: true,
+      parseNested: true,
+    }),
+  )
 
   /**
    * Cache
@@ -206,7 +221,7 @@ async function consturctServer(moduleDefs) {
 
   for (const moduleDef of moduleDefinitions) {
     // Register the route.
-    app.use(moduleDef.route, async (req, res) => {
+    app.all(moduleDef.route, async (req, res) => {
       ;[req.query, req.body].forEach((item) => {
         // item may be undefined (some environments / middlewares).
         // Guard access to avoid "Cannot read properties of undefined (reading 'cookie')".
@@ -227,25 +242,30 @@ async function consturctServer(moduleDefs) {
         const moduleResponse = await moduleDef.module(query, (...params) => {
           // 参数注入客户端IP
           const obj = [...params]
-          let ip = req.ip
+          const options = obj[2] || {}
+          if (!options.randomCNIP) {
+            let ip = req.ip
 
-          if (ip.substring(0, 7) == '::ffff:') {
-            ip = ip.substring(7)
-          }
-          if (ip == '::1') {
-            ip = global.cnIp
-          }
-          // logger.info('Requested from ip:', ip)
-          obj[3] = {
-            ...obj[3],
-            ip,
+            if (ip.substring(0, 7) == '::ffff:') {
+              ip = ip.substring(7)
+            }
+            if (ip == '::1') {
+              ip = global.cnIp
+            }
+            // logger.info('Requested from ip:', ip)
+            obj[2] = {
+              ...options,
+              ip,
+            }
           }
+
           return request(...obj)
         })
         logger.info(`Request Success: ${decode(req.originalUrl)}`)
 
+        // 夹带私货部分：如果开启了通用解锁，并且是获取歌曲URL的接口，则尝试解锁（如果需要的话）ヾ(≧▽≦*)o
         if (
-          (req.baseUrl === '/song/url/v1' || req.baseUrl === '/song/url') &&
+          req.baseUrl === '/song/url/v1' &&
           process.env.ENABLE_GENERAL_UNBLOCK === 'true'
         ) {
           const song = moduleResponse.body.data[0]
@@ -260,7 +280,7 @@ async function consturctServer(moduleDefs) {
             logger.info('Starting unblock(uses general unblock):', req.query.id)
             const result = await matchID(req.query.id)
             song.url = result.data.url
-            song.freeTrialInfo = 'null'
+            song.freeTrialInfo = null
             logger.info('Unblock success! url:', song.url)
           }
           if (song.url && song.url.includes('kuwo')) {
@@ -288,6 +308,11 @@ async function consturctServer(moduleDefs) {
             }
           }
         }
+        if (moduleResponse.redirectUrl) {
+          res.redirect(moduleResponse.status || 302, moduleResponse.redirectUrl)
+          return
+        }
+
         res.status(moduleResponse.status).send(moduleResponse.body)
       } catch (/** @type {*} */ moduleResponse) {
         logger.error(`${decode(req.originalUrl)}`, {

package/util/fileHelper.js

@@ -0,0 +1,88 @@
+const fs = require('fs')
+const crypto = require('crypto')
+const logger = require('./logger')
+
+function isTempFile(file) {
+  return !!(file && file.tempFilePath)
+}
+
+async function getFileSize(file) {
+  if (isTempFile(file)) {
+    const stats = await fs.promises.stat(file.tempFilePath)
+    return stats.size
+  }
+  return file.data ? file.data.byteLength : file.size || 0
+}
+
+async function getFileMd5(file) {
+  if (file.md5) {
+    return file.md5
+  }
+
+  if (isTempFile(file)) {
+    return new Promise((resolve, reject) => {
+      const hash = crypto.createHash('md5')
+      const stream = fs.createReadStream(file.tempFilePath)
+      stream.on('data', (chunk) => hash.update(chunk))
+      stream.on('end', () => resolve(hash.digest('hex')))
+      stream.on('error', reject)
+    })
+  }
+
+  if (file.data) {
+    return crypto.createHash('md5').update(file.data).digest('hex')
+  }
+
+  throw new Error('无法计算文件MD5: 缺少文件数据')
+}
+
+function getUploadData(file) {
+  if (isTempFile(file)) {
+    return fs.createReadStream(file.tempFilePath)
+  }
+  return file.data
+}
+
+async function cleanupTempFile(filePath) {
+  if (!filePath) return
+  try {
+    await fs.promises.unlink(filePath)
+  } catch (e) {
+    logger.info('临时文件清理失败:', e.message)
+  }
+}
+
+async function readFileChunk(filePath, offset, length) {
+  const fd = await fs.promises.open(filePath, 'r')
+  const buffer = Buffer.alloc(length)
+  await fd.read(buffer, 0, length, offset)
+  await fd.close()
+  return buffer
+}
+
+function getFileExtension(filename) {
+  if (!filename) return 'mp3'
+  if (filename.includes('.')) {
+    return filename.split('.').pop().toLowerCase()
+  }
+  return 'mp3'
+}
+
+function sanitizeFilename(filename) {
+  if (!filename) return 'unknown'
+  return filename
+    .replace(/\.[^.]+$/, '')
+    .replace(/\s/g, '')
+    .replace(/\./g, '_')
+}
+
+module.exports = {
+  isTempFile,
+  getFileSize,
+  getFileMd5,
+  getUploadData,
+  cleanupTempFile,
+  readFileChunk,
+  getFileExtension,
+  sanitizeFilename,
+}