api.pancdn.net

多平台音乐聚合 API · 搜索 / 歌单 / 歌词 / 封面 / 播放地址

支持 CORS 跨域 网易云 netease QQ音乐 tencent 酷狗 kugou

快速开始

所有接口基础路径为 https://api.pancdn.net/api/v1，返回 JSON（歌词文本接口除外）。前端可直接 fetch 调用，无需后端中转。

健康检查 
GET https://api.pancdn.net/healthz
查看可用平台 
GET https://api.pancdn.net/api/v1/providers

路径规则

/api/v1/{provider}/{resource}/...
provider平台
netease网易云音乐
tencentQQ 音乐
kugou酷狗音乐

常用接口

搜索歌曲

GET/api/v1/{provider}/search?q=关键词&page=1&limit=30

参数 q 或 keyword 均可。返回 items / songs 列表。

https://api.pancdn.net/api/v1/netease/search?q=晴天&page=1&limit=10

单曲详情

GET/api/v1/{provider}/songs/{id}
https://api.pancdn.net/api/v1/netease/songs/210049

播放地址（推荐）

GET/api/v1/{provider}/songs/{id}/stream?redirect=false&quality=lossless

加 redirect=false 返回 JSON，含官方 CDN 直链 url，浏览器可直连播放/下载。

音质 quality 可选：standard · exhigh · lossless · hires 等。

https://api.pancdn.net/api/v1/netease/songs/210049/stream?redirect=false&quality=exhigh

歌词

GET/api/v1/{provider}/songs/{id}/lyric
GET/api/v1/{provider}/songs/{id}/lyric?format=json

默认返回 LRC 文本；format=json 返回结构化歌词。

封面

GET/api/v1/{provider}/songs/{id}/cover?size=600

默认 302 跳转图片地址；加 redirect=false 返回 {"url":"..."}。

歌单

GET/api/v1/{provider}/playlists/{id}

返回歌单名、封面、歌曲列表。网易云示例：

https://api.pancdn.net/api/v1/netease/playlists/2859214503

专辑 / 歌手

GET/api/v1/{provider}/albums/{id}
GET/api/v1/{provider}/artists/{id}?limit=50

站点如何引用

JavaScript（浏览器 / 前端项目）

const API = 'https://api.pancdn.net';

// 搜索
const res = await fetch(`${API}/api/v1/netease/search?q=周杰伦&limit=10`);
const data = await res.json();
console.log(data.items);

// 获取播放直链
const stream = await fetch(
  `${API}/api/v1/netease/songs/210049/stream?redirect=false&quality=exhigh`
).then(r => r.json());

// 用返回的 url 播放（直连平台 CDN）
const audio = new Audio(stream.url);
audio.play();

// 歌词（LRC 文本）
const lrc = await fetch(`${API}/api/v1/netease/songs/210049/lyric`).then(r => r.text());

// 封面（可直接作 img src，或 redirect=false 取 url）
const cover = `${API}/api/v1/netease/songs/210049/cover?size=600`;

curl

curl "https://api.pancdn.net/api/v1/tencent/search?q=稻香&limit=5"
curl "https://api.pancdn.net/api/v1/kugou/songs/{hash}/stream?redirect=false"

接入示例项目

开源前端 music.bi 已接入本 API，环境变量：

VITE_API_BASE=https://api.pancdn.net

响应字段说明

歌曲对象常见字段：

字段说明
id平台歌曲 ID（酷狗为 hash）
name歌名
artist / artists歌手
album专辑名
url本 API 的 stream 地址（item 内）
cover / lyric封面、歌词 API 地址（item 内）

播放接口 JSON 示例：{"url":"...","format":"mp3","br":320,"size":...,"quality":"exhigh"}

说明