音乐 API 文档

简洁的酷我音乐搜索与播放接口，无需鉴权、无 KV 存储依赖。

BASE_URL

接口目录

GET 搜索歌曲
GET 播放（重定向）
GET 播放代理（音频流）
GET 获取直链

GET /api/search

根据关键词搜索酷我音乐歌曲，返回歌曲列表。优先使用酷我官方接口，失败时自动回退到备用源。结果缓存 1 小时。

请求参数

参数	类型	说明
`keyword`必填	string	搜索关键词，如歌曲名、歌手名

请求示例

curl ""

成功响应

{
  "ok": true,
  "songs": [
    {
      "rid": "76331783",
      "name": "夜曲",
      "artist": "周杰伦",
      "album": "十一月的萧邦",
      "pic": "https://img.../120/xxx.jpg"
    }
  ]
}

错误响应

{
  "error": "缺少 keyword"
}
// HTTP 400 或 502

▶ 在线测试

GET /api/play

根据歌曲 RID 获取可用播放源，并 302 重定向到第一个可用音频直链。适用于 <audio> 标签直接播放（需目标源支持 CORS）。

请求参数

参数	类型	说明
`id`必填	string	歌曲 RID（来自搜索接口）

请求示例

curl -L ""

响应

// 成功：302 重定向到音频 URL
HTTP/1.1 302 Found
Location: https://xxx.com/xxx.flac

// 失败：JSON 错误
{
  "error": "未找到可用源"
}

▶ 在线测试

GET /api/play-data

服务端代理拉取音频数据流并返回，自动附带 Access-Control-Allow-Origin: *。解决浏览器跨域（CORS）导致的播放失败问题。推荐前端播放器使用此接口。

请求参数

参数	类型	说明
`id`必填	string	歌曲 RID

请求示例

curl "" -o song.mp3

响应头

Content-Type: audio/mpeg 或 audio/flac
Access-Control-Allow-Origin: *
Cache-Control: no-store

前端使用示例

const audio = document.querySelector('audio');
audio.src = `BASE_URL/api/play-data?id=${rid}`;
audio.play();

▶ 在线测试

GET /api/play-data-url

返回所有可用源中第一个允许跨域的音频直链（JSON 格式）。如果所有源均不允许 CORS，则返回 url: null，此时应改用 /api/play-data 代理播放。

请求参数

参数	类型	说明
`id`必填	string	歌曲 RID

请求示例

curl ""

成功响应

{
  "ok": true,
  "url": "https://xxx.com/xxx.flac",
  "format": "flac"
}

无可跨域源时

{
  "ok": true,
  "url": null,
  "format": null
}

▶ 在线测试