Musicbox API

多平台音乐 API 服务 · 基于 Express + ESM

Express 5 v1.0.0 netease tencent

接口列表

GET /api/search — 搜索歌曲
参数必填说明
keyword* 是 搜索关键词
page 否 页码，默认 1
limit 否 每页数量，默认 30
type 否 分类，默认 1（歌曲）
site 否 平台：netease(默认) / tencent
GET http://api.music.caikun.cc/api/search?keyword=稻香&limit=5
GET /api/song/:id — 歌曲详情
参数必填说明
id* 是 歌曲 ID（netease 数字 / tencent mid 字符串）
site 否 平台
GET http://api.music.caikun.cc/api/song/35847388
GET /api/album/:id — 专辑信息
参数必填说明
id* 是 专辑 ID
site 否 平台
GET http://api.music.caikun.cc/api/album/35847388
GET /api/artist/:id — 艺术家作品
参数必填说明
id* 是 艺术家 ID
limit 否 数量，默认 50
site 否 平台
GET http://api.music.caikun.cc/api/artist/6452?limit=10
GET /api/playlist/:id — 播放列表
参数必填说明
id* 是 歌单 ID
site 否 平台
GET http://api.music.caikun.cc/api/playlist/3778678
GET /api/url/:id — 播放链接
参数必填说明
id* 是 歌曲 ID
br 否 比特率 kbps，默认 320
site 否 平台
GET http://api.music.caikun.cc/api/url/35847388?br=320
GET /api/lyric/:id — 歌词
参数必填说明
id* 是 歌曲 ID
site 否 平台
GET http://api.music.caikun.cc/api/lyric/35847388
GET /api/pic/:id — 封面图片 URL
参数必填说明
id* 是 图片 ID
size 否 尺寸，默认 300
site 否 平台
GET http://api.music.caikun.cc/api/pic/35847388?size=300
GET /api/health — 健康检查
GET http://api.music.caikun.cc/api/health

响应格式

所有接口统一返回 { code, data, message } 结构：

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

标准化歌曲结构（search / song / album / artist / playlist 返回数组）：

{
  "id": "001Bbywq2gicae",
  "name": "搁浅",
  "artist": ["周杰伦"],
  "album": "七里香",
  "pic": "003DFRzD192KKD",
  "url": "001Bbywq2gicae",
  "lyric": "001Bbywq2gicae",
  "source": "tencent"
}

错误码

codeHTTP说明
BAD_PLATFORM 400 （动态消息）
BAD_PARAMS 400 （动态消息）
NOT_FOUND 404 未找到相关内容
URL_NOT_FOUND 404 未找到可用的播放链接
TIMEOUT 504 请求超时，请稍后重试
UPSTREAM_ERROR 502 上游服务不可用
PARSE_ERROR 502 上游响应解析失败
CIRCUIT_OPEN 503 服务暂时不可用，请稍后重试
INTERNAL 500 服务器内部错误