# 网易云音乐

**请求方式:** GET

**接口地址:** https://api.hk0.cc/api/netease

**接口描述:** 网易云音乐搜索与解析: 支持关键词搜索、按歌曲ID取详情/直链/歌词、解析分享链接、获取 LRC 歌词(含翻译); keyword+n 可直接出单曲. 多源组合(官方接口 + gdstudio + 本地镜像), 付费/版权受限曲目返回元数据并标记 playable=false 与原因; 音质支持 无损/320k/192k/128k 四档.

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| type | string | query | 可选 | — | — | 操作类型: search 搜索 / song 歌曲详情(含直链与歌词) / url 仅返回直链 / lyric 仅返回歌词; 不传时按参数自动判断(id 优先, keyword+n 出单曲) |
| keyword | string | query | 可选 | — | — | 搜索关键词, 如 周杰伦、晴天、卡农; type=search 时必填。也接受 s/msg/name/q/w/text |
| id | string | query | 可选 | — | — | 网易云歌曲 ID, 如晴天 186016。也接受 contentId/cid/mid/songid; id 类接口(type=song/url/lyric)传纯数字关键词会自动当 id |
| url | string | query | 可选 | — | — | 网易云歌曲分享链接, 自动提取其中的歌曲 ID |
| page | int | query | 可选 | — | — | 页码, 默认 1 |
| limit | int | query | 可选 | — | — | 每页数量, 默认 10, 最大 30。也接受 pageSize/count |
| br | string | query | 可选 | — | — | 音质: 1 无损 / 2 320k / 3 192k / 4 128k, 默认 4。也接受 quality/level; 付费/版权曲在免费源普遍无直链 |
| lyric | int | query | 可选 | — | — | 传 0 不返回歌词 (默认 1 返回, 含翻译 tlyric) |
| fresh | int | query | 可选 | — | — | 传 1 跳过缓存强制刷新 |
| n | int | query | 可选 | — | — | 选曲序号: 配合 keyword 使用, 传 n=1 直接返回第 1 首完整信息(含直链与歌词)。也接受 index/num |

## 返回示例

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "platform": "netease",
    "id": "478507889",
    "name": "卡农(经典钢琴版)",
    "artist": "dylanf",
    "artist_list": [
      "dylanf"
    ],
    "album": "卡农Canon in D",
    "album_id": "35308023",
    "duration": 300,
    "cover": "https://p3.music.126.net/.../109951165175371079.jpg",
    "pay": false,
    "playable": true,
    "quality": "standard",
    "bit_rate": 128,
    "ext": "mp3",
    "url": "https://m701.music.126.net/....mp3",
    "source": "gdstudio",
    "web_url": "https://music.163.com/#/song?id=478507889",
    "lyric": "[00:01.00]作曲 : dylanf"
  }
}
```