某易云点歌V2 API 文档

提示：本接口为 V2 版本，推荐使用更新的 V3 版本以获得更好的体验。本文档仅描述 V2 接口的调用方式与参数。

接口说明

某易云点歌 API 提供音乐搜索与播放链接获取的一站式服务。通过本接口，您可以：

• 根据关键词搜索歌曲，获取歌曲列表及 UID。
• 通过歌曲 ID 直接获取播放链接。
• 获取歌词、专辑信息等。
• 支持多种音质选择，从标准音质到超清母带。
• 支持付费歌曲获取（付费专辑除外）。

接口采用密钥鉴权，所有请求必须携带有效的 key 参数。

调用地址

https://api.xunjinlu.fun/api/wyy/dg/v2.php

请求方式

支持 GET 与 POST 两种方式。参数可通过 URL 查询字符串（Query）或请求体（application/x-www-form-urlencoded 或 multipart/form-data）传递。

请求参数

参数组合说明

成功响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "urls": [
      {
        "id": "1345872140",
        "url": "https://m8.music.126.net/20260511205950/88af518c8cccdd576bc8a08a3ed0368f/ymusic/obj/w5zDlMODwrDDiGjCn8Ky/14055612447/cba4/22ea/82dd/6b234e55fbeadde71d872c8b80e2c409.mp3?vuutv=aqfornnAuRRF8GJvNSpA7EQC/zQYFYbNbg1TOL36gQDD7hsZPLFlETzQxzm1BuUE9ovgA5pRQa/QTlRkej8rE4BVJCnZNaWHZS+ynE7WlB0=",
        "br": 320000,
        "level": "exhigh",
        "size": 7344045,
        "md5": "6b234e55fbeadde71d872c8b80e2c409",
        "time": 183536
      }
    ],
    "count": 1
  },
  "timestamp": 1778502890
}

响应字段说明

注：当 action=search 返回列表时，data 结构可能包含 list 数组，每个元素包含歌曲基本信息（ID、名称、歌手、专辑等），具体字段以实际返回为准。

错误响应示例

当请求出现错误时，返回的 JSON 结构如下：

{
  "code": 0,
  "msg": "未提供密钥",
  "errcode": 11001
}

业务错误码（errcode）

频率限制

• 每分钟约 10 次请求。
• 超过限制将返回 errcode: 11005 错误。

调用示例（PHP）

以下示例展示如何通过 PHP 调用本接口。注意：示例中省略了 `` 标签，仅保留核心逻辑。

// 搜索歌曲示例
$key = 'sk_xxxxxxxxxxxxxxxx';
$action = 'search';
$keywords = '稻香';
$limit = 10;

$url = "https://api.xunjinlu.fun/api/wyy/dg/v2.php?key={$key}&action={$action}&keywords=" . urlencode($keywords) . "&limit={$limit}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['code'] == 200) {
    // 处理搜索结果
    print_r($result['data']);
} else {
    echo "错误: " . $result['msg'] . " (errcode: " . $result['errcode'] . ")";
}

// 获取播放链接示例
$key = 'sk_xxxxxxxxxxxxxxxx';
$action = 'url';
$id = '1345872140';
$quality = 'exhigh';

$url = "https://api.xunjinlu.fun/api/wyy/dg/v2.php?key={$key}&action={$action}&id={$id}&quality={$quality}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['code'] == 200) {
    $playUrl = $result['data']['urls'][0]['url'];
    echo "播放链接: " . $playUrl;
} else {
    echo "错误: " . $result['msg'] . " (errcode: " . $result['errcode'] . ")";
}

注意事项

• 所有参数均通过 Query 字符串传递，即使使用 POST 方式，也请将参数放在 URL 查询字符串中，或同时支持 POST body。
• key 参数必须有效，否则将返回鉴权错误。
• 音质等级 standard 及以上可能需要调用方拥有相应的 VIP 权限，否则可能无法获取播放链接。
• 接口返回的播放链接具有时效性，建议在获取后尽快使用。
• 本接口免费调用，但请合理使用，避免恶意高频请求。