网易云播放音乐

接口说明

本接口根据歌曲 ID 返回可播放的音频地址，当前提供 30 秒试听版本。适合需要在应用、页面或小程序中快速接入歌曲试听能力的开发者使用。接口免费调用，无需密钥。

调用地址

https://mini10.top/api/player.php

请求方式

GET

鉴权说明

本接口无需密钥，可直接调用，免费使用。

请求时仅需在查询字符串中提供歌曲 id（参数 ids）即可，例如：

https://mini10.top/api/player.php?ids=歌曲id

请求参数

调用地址：https://mini10.top/api/player.php，请求方式：GET。本接口无需密钥。

参数取值说明：

• ids 为网易云音乐歌曲 id，以纯数字字符串形式传入，单次传入一首歌曲的 id。
• 仅提供 30 秒试听片段；完整播放需登录 cookie 且账号具备 VIP 权限，该能力不在本接口开放范围内。
• 返回内容中的 tips 提示由调用方在本地发起播放请求，请求地址与参数以返回结果中的 url、param、methods 为准。

成功响应示例

{
  "url": "https://music.163.com/weapi/song/enhance/player/url/v1",
  "param": "params=8kLP5tx3AUEN2waqzq1VfO1yGcHjUQU%2Boi0S1%2BnnwT5ccCVAzoJ%2F7mQg60JJFWaR8CI86FkPKifCHmYS%2Bs6VX7LgaHVs44V06l7t9LKBToFsXpDBF5NdiLQNVUlo25SV&encSecKey=72ca6ab8fdee8151e7e879435796970f75552fb012893881b36315db2772f3e2ee101a6199da06875362736c904f1607bb5a5577cbb865f40181a090d1802a73a3e85892f49269ce199773f689b590eb71f87df9b8f715720b30af1cbe3702530cd65585166dc12a90fdacb95531af6d28cd5b2f229158e9cad754ed10ae151c",
  "methods": "POST",
  "tips": "由于服务器ip被拉黑, 所以让你们本地访问. "
}

响应字段说明

说明：接口以 JSON 对象返回，字段固定为上述四项。使用时按 methods 指定的方法，将 param 作为请求体提交到 url，即可获得对应歌曲的音频播放地址。ids 传入的歌曲 id 不同，返回的 param 内容随之变化，其余字段保持稳定。

错误响应示例

接口在参数缺失、接口不可用或服务异常时，统一返回 JSON 结构，HTTP 状态码仍为 200，业务结果通过 errcode 字段标识：code 为 0 表示业务返回体，errcode 为具体业务错误码，msg 为可读的错误说明。

{
  "code": 0,
  "msg": "歌曲id不能为空",
  "errcode": 11013
}

{
  "code": 0,
  "msg": "请求过于频繁，请稍后再试",
  "errcode": 11005
}

调用方应以 errcode 是否为 0 之外的已知业务码判断失败原因，不要仅依赖 HTTP 状态码或 msg 文本。

业务错误码说明

下表为本站接口对外返回的全部业务错误码及其含义，调用方可按 errcode 做分支处理。

本接口为免费接口、无需密钥，实际调用中最常见的是 11013（参数缺失或接口路径不匹配）、11005（频率超限）、11017（服务暂不可用）与 11018（请求方式不是 GET）。

调用示例

终端 curl（bash）

curl -G "https://mini10.top/api/player.php" \
  --data-urlencode "ids=1901371647"

PHP

// PHP 示例：使用 cURL 调用
$url = "https://mini10.top/api/player.php?ids=1901371647";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
echo $response;

注意事项

• 试听时长限制：本接口仅返回 30 秒试听音频。完整版播放依赖网易云账号登录 Cookie 及该账号的会员权限，本站不提供相关凭据，请勿据此判断接口异常。
• 返回结果不是音频直链：响应中的 url、param 与 methods 是一组配套的请求信息，需由客户端按 methods 指定的方式、携带 param 内容自行发起请求才能获取音频。请勿将 url 直接当作可播放文件地址使用，也不要对其做缓存分发。
• ids 参数取值：必填，字符串类型，传单个歌曲 id。拼接进查询串前请做 URL 编码，避免 id 中含有特殊字符导致参数截断；空值或非歌曲 id 一般无法得到有效结果。
• 无需密钥不等于可滥用：本接口免费且没有密钥，但请勿在页面加载、滚动等场景中无节制调用。建议按歌曲 id 做本地缓存，同一 id 短时间内不重复请求；对外提供服务时请自行做好调用频率约束，异常高频可能被限流或拒绝响应。
• 密钥与凭据安全：本接口本身不涉及密钥，但若你自行在业务侧接入账号 Cookie 或会员凭据，务必保存在服务端，禁止写入前端代码、公开仓库或日志中；本接口也不接收、不转发任何此类凭据。
• 传输与调用地址：请通过 HTTPS 访问 https://mini10.top/api/player.php，保持域名与路径原样，不要改为 HTTP 或自行拼接其它路径，以免请求失败。
• 异常与兼容处理：返回内容可能随歌曲版权状态、地区限制或服务调整而变化。请对响应做判空处理，若缺少有效请求信息或后续取流失败，向用户提示「暂无可用试听」而不是抛出原始报文。返回的 param 等字段为加密串，请勿在界面或日志中