Music API Hub

所有音乐数据，一个地址。重试 / 超时 / 降级 / 归一化 / 翻页全部在 Worker 内完成，客户端只管 fetch。

Bare Worker · 零绑定无 KV / D1 / R2 / DO音源：海棠 → 飞飞 → NetstartNetstart v4.41.1 · api-enhanced

唯一入口

不带参数 = 本页文档；带任意参数 = JSON。/api/music 是同一地址的别名。

在线试一试

点击上方按钮，或直接填写参数后发送。

能力与 action

action参数返回
fullid, level, cap, with歌曲全量聚合：详情 + 歌词 + 评论 + 音质上限 + 播放直链（默认，传 id 时）
discoverkeywords, page, level首页 + 搜索 + 首条结果全量聚合（默认，传 keywords 时）
allid / keywords, level一次拿全：home + search + full
home—热搜（简版+详情）、默认搜索词、每日新歌、Banner、排行榜
searchkeywords, page, limit, offset归一化搜索结果
detailid歌曲详情
lyricid歌词：vkeys 逐字 → Netstart → 飞飞 lrcgc
commentsid, limit热评 + 最新评论
capid音质上限探测：海棠 cap → 飞飞 act=info
playid, level播放直链：海棠 → 飞飞 → Netstart /song/url/v1，附完整降级链
playlistid歌单元信息 + 全量曲目（自动翻页）
rawpath=...透传 api-enhanced 的任意增强接口，零逻辑接入全部新能力
health—各上游实时健康探测与时延
index—返回本能力清单（JSON）

播放链路优先级

① 海棠POST resolve-url · 主/备网关
→
② 飞飞act=musicurl · 302 直跳
→
③ NetstartGET /song/url/v1

每一级内部按目标档位向下并发探测，取最高可用档；单级全失败才进入下一级。chain 字段完整记录每一步结果。

响应结构

  • ok / action / query — 状态与请求回显
  • data — 聚合结果；单个数据源失败时该块为 {ok:false,error}，不影响其它块
  • meta.sources — 各上游实时可用性与耗时
  • meta.degraded — 发生过的降级原因
  • meta.cache — HIT / MISS / BYPASS（只读数据短缓存）

通用参数

  • level — standard / 192 / exhigh / lossless / hires / jymaster
  • cap=0 — 关闭音质上限探测；with= — 挑选 full 里的数据块
  • nocache=1 — 绕过缓存；pretty=1 — 格式化 JSON
  • path= — raw 模式透传任意 api-enhanced 接口，例如 /search/hot/detail、/banner、/top/song、/playlist/import

部署与配置

第三方接口无 SLA，字段与可用性可能随时变化 · v1.0.0