Music API

接口文档

网易云音乐开放数据接口，统一响应、开箱即用。

12 公开接口 20,583 次请求 5–10m 缓存周期 JSON 统一响应 服务状态 ↗
GET /api/song

歌曲详情

Query 参数

id 必填

歌曲 ID

Request 
GET http://api.music.caikun.cc/api/song?id=35847388
Response
{
  "code": 200,
  "data": {
    "id": 35847388,
    "name": "稻香",
    "artists": [
      {
        "id": 6452,
        "name": "周杰伦"
      }
    ],
    "album": {
      "id": 19077,
      "name": "魔杰座"
    },
    "pic": "109951166446935400",
    "duration": 223000,
    "qualities": [
      {
        "level": "standard",
        "br": 128,
        "size": 3568123,
        "sr": 44100
      },
      {
        "level": "exhigh",
        "br": 320,
        "size": 8900000,
        "sr": 44100
      },
      {
        "level": "lossless",
        "br": 936,
        "size": 26000000,
        "sr": 44100
      }
    ],
    "url": 35847388,
    "lyric": 35847388
  },
  "message": "ok"
}
GET /api/url

播放地址

Query 参数

id 必填

歌曲 ID

level

音质等级，standard/higher/exhigh/lossless/hires，默认 exhigh，实际音质以账号权限为准

Request 
GET http://api.music.caikun.cc/api/url?id=35847388&level=exhigh
Response
{
  "code": 200,
  "data": {
    "url": "https://...",
    "size": 8912345,
    "br": 320,
    "level": "exhigh",
    "type": "mp3"
  },
  "message": "ok"
}
GET /api/lyric

歌词

Query 参数

id 必填

歌曲 ID

Request 
GET http://api.music.caikun.cc/api/lyric?id=35847388
Response
{
  "code": 200,
  "data": {
    "lyric": "[00:00.00] 作曲 : 周杰伦\n[00:01.00]看着那白色的蜻蜓...",
    "tlyric": "",
    "yrc": "[1000,3000](1000,500,0)看(1500,500,0)着...",
    "romalrc": "",
    "ytlrc": ""
  },
  "message": "ok"
}
GET /api/pic

封面图 URL

Query 参数

id 必填

图片 ID

size

图片尺寸，默认 300，范围 100-2000，越界回退默认值

Request 
GET http://api.music.caikun.cc/api/pic?id=109951166446935400&size=300
Response
{
  "code": 200,
  "data": {
    "url": "https://p3.music.126.net/xxx/109951166446935400.jpg?param=300y300"
  },
  "message": "ok"
}
GET /api/toplist

排行榜

Request 
GET http://api.music.caikun.cc/api/toplist
Response
{
  "code": 200,
  "data": [
    {
      "id": 19723756,
      "name": "飙升榜",
      "pic": "109951170048506929",
      "playCount": 6476136960,
      "trackCount": 100,
      "creator": "网易云音乐",
      "creatorAvatar": "",
      "description": "云音乐中每天热度上升最快的100首单曲，每日更新。",
      "tags": []
    }
  ],
  "message": "ok"
}
GET /api/hot

热门歌单

Query 参数

limit

返回数量，默认 20，范围 1-100，越界回退默认值

Request 
GET http://api.music.caikun.cc/api/hot?limit=10
Response
{
  "code": 200,
  "data": [
    {
      "id": 14276963642,
      "name": "华语热歌精选",
      "pic": "109951166446935400",
      "playCount": 15383,
      "trackCount": 97,
      "creator": "",
      "creatorAvatar": "",
      "description": "",
      "tags": []
    }
  ],
  "message": "ok"
}
GET /api/artists

歌手分类列表

Query 参数

type

分类：-1全部, 1男, 2女, 3乐队

area

地区：-1全部, 7华语, 96欧美, 8日本, 16韩国, 0其他

initial

首字母：-1热门, 0其他, a-z

limit

每页数量，默认 30，范围 1-100，越界回退默认值

offset

偏移量，默认 0

Request 
GET http://api.music.caikun.cc/api/artists?area=7&type=1&limit=10
Response
{
  "code": 200,
  "data": [
    {
      "id": 6452,
      "name": "周杰伦",
      "pic": "109951166446935400",
      "albumSize": 15,
      "mvSize": 80,
      "musicSize": 300,
      "followed": false
    }
  ],
  "message": "ok"
}
GET /api/playlist

歌单歌曲

Query 参数

id 必填

歌单或排行榜 ID

Request 
GET http://api.music.caikun.cc/api/playlist?id=3778678
Response
{
  "code": 200,
  "data": [
    {
      "id": 35847388,
      "name": "稻香",
      "artists": [
        {
          "id": 6452,
          "name": "周杰伦"
        }
      ],
      "album": {
        "id": 19077,
        "name": "魔杰座"
      },
      "pic": "109951166446935400",
      "duration": 223000,
      "qualities": [
        {
          "level": "standard",
          "br": 128,
          "size": 3568123,
          "sr": 44100
        },
        {
          "level": "exhigh",
          "br": 320,
          "size": 8900000,
          "sr": 44100
        },
        {
          "level": "lossless",
          "br": 936,
          "size": 26000000,
          "sr": 44100
        }
      ],
      "url": 35847388,
      "lyric": 35847388
    }
  ],
  "message": "ok"
}
GET /api/album

专辑详情

Query 参数

id 必填

专辑 ID

Request 
GET http://api.music.caikun.cc/api/album?id=34720827
Response
{
  "code": 200,
  "data": {
    "album": {
      "id": 34720827,
      "name": "周杰伦的床边故事",
      "artist": "周杰伦",
      "publishTime": 1223769600000,
      "size": 11,
      "pic": "109951166446935400",
      "description": ""
    },
    "songs": [
      {
        "id": 35847388,
        "name": "稻香",
        "artists": [
          {
            "id": 6452,
            "name": "周杰伦"
          }
        ],
        "album": {
          "id": 19077,
          "name": "魔杰座"
        },
        "pic": "109951166446935400",
        "duration": 223000,
        "qualities": [
          {
            "level": "standard",
            "br": 128,
            "size": 3568123,
            "sr": 44100
          },
          {
            "level": "exhigh",
            "br": 320,
            "size": 8900000,
            "sr": 44100
          },
          {
            "level": "lossless",
            "br": 936,
            "size": 26000000,
            "sr": 44100
          }
        ],
        "url": 35847388,
        "lyric": 35847388
      }
    ]
  },
  "message": "ok"
}
GET /api/artist/info

歌手信息

Query 参数

id 必填

歌手 ID

limit

歌曲数量，默认 50，范围 1-60（上游热门歌曲最多 60 首），越界回退默认值

Request 
GET http://api.music.caikun.cc/api/artist/info?id=6452&limit=10
Response
{
  "code": 200,
  "data": {
    "artist": {
      "id": 6452,
      "name": "周杰伦",
      "pic": "109951166446935400",
      "briefDesc": "周杰伦，华语流行乐男歌手...",
      "musicSize": 300,
      "albumSize": 15,
      "mvSize": 80,
      "followed": false
    },
    "songs": [
      {
        "id": 35847388,
        "name": "稻香",
        "artists": [
          {
            "id": 6452,
            "name": "周杰伦"
          }
        ],
        "album": {
          "id": 19077,
          "name": "魔杰座"
        },
        "pic": "109951166446935400",
        "duration": 223000,
        "qualities": [
          {
            "level": "standard",
            "br": 128,
            "size": 3568123,
            "sr": 44100
          },
          {
            "level": "exhigh",
            "br": 320,
            "size": 8900000,
            "sr": 44100
          },
          {
            "level": "lossless",
            "br": 936,
            "size": 26000000,
            "sr": 44100
          }
        ],
        "url": 35847388,
        "lyric": 35847388
      }
    ]
  },
  "message": "ok"
}
GET /api/health

健康检查

Request 
GET http://api.music.caikun.cc/api/health
Response
{
  "code": 200,
  "data": {
    "status": "ok",
    "timestamp": 1711728000000,
    "cache": {
      "entries": 15,
      "hits": 42,
      "misses": 10
    }
  },
  "message": "ok"
}

响应格式

所有接口使用一致的响应外壳，列表与对象仅出现在 data 字段中；失败消息以稳定业务错误码开头。

{
  "code": 200,
  "data": {},
  "message": "ok"
}

code HTTP 语义状态码

data 当前接口的数据对象或数组

message 请求结果说明，失败时格式为 [错误码] 详细说明

{
  "code": 400,
  "data": null,
  "message": "[BAD_PARAMS] 参数无效：缺少 id"
}

失败响应示例

message 以错误码前缀提供稳定的错误分类和详细说明

错误码

可预期错误会返回明确的 HTTP 状态，以及含稳定业务错误码与详细说明的消息。

BAD_PARAMS 400

动态消息

PAYLOAD_TOO_LARGE 413

请求内容过大

NOT_FOUND 404

未找到相关内容

URL_NOT_FOUND 404

未找到可用的播放链接

TIMEOUT 504

请求超时，请稍后重试

UPSTREAM_ERROR 502

上游服务不可用

PARSE_ERROR 502

上游响应解析失败

UPSTREAM_PROTOCOL_ERROR 502

上游服务响应异常

CIRCUIT_OPEN 503

服务暂时不可用，请稍后重试

INTERNAL 500

服务器内部错误

COOKIE_EXPIRED 401

Cookie 已失效，请重新设置

COOKIE_REQUIRED 401

需要先设置 Cookie

COOKIE_REFRESH 401

登录态续期失败，请重新设置 Cookie