{"status":"ok","message":"Aurora Music Source Service","apiKeyRequired":true,"capabilities":["search","track","playlist","lyric","recommend","toplists","toplist"],"endpoints":{"search":"/aurora?query={query}&quality={quality}&key=<API_KEY>","track":"/aurora/track?id={id}&quality={quality}&key=<API_KEY>","playlist":"/aurora/playlist?url={url}&limit={limit}&key=<API_KEY>","lyric":"/aurora/lyric?track={track}&artist={artist}&duration={duration}&key=<API_KEY>","recommend":"/aurora/recommend?categoryId={categoryId}&sortId={sortId}&page={page}&limit={limit}&key=<API_KEY>","toplists":"/aurora/toplists?preview={preview}&key=<API_KEY>","toplist":"/aurora/toplist?id={id}&page={page}&limit={limit}&key=<API_KEY>"},"request":{"query":"搜索词，必填（客户端把 {query} 替换成 URL 编码后的搜索词）","id":"单曲取址：源内曲目 id（搜索结果条目里的 id / songmid），必填（客户端把 {id} 替换成 URL 编码后的 id）；别名 songmid / mid。同名不同版本（变速版 / 翻唱 / Live）用关键词搜不出唯一结果，曲目已定时一律用本参数取址","quality":"可选（客户端把 {quality} 替换成 128 / 320 / flac）；别名 level / br / format；不传则用源默认档位","rank":"可选（别名 sort）：release = 同名曲组内把发行最早者（原唱）提到组首，其余顺序不动；off = 保持上游原序。**不传即用源默认（默认 release）**，故不带该参数的旧端点模板同样生效","url":"歌单分享链接，必填（客户端把 {url} 替换成 URL 编码后的歌单链接）；支持主流音乐平台；也可用 ?server=<平台>&id=<歌单号> 直连","limit":"歌单可选（客户端把 {limit} 替换成首屏需要的曲目数）：只向上游取前 N 首，total / truncated 仍按全量报，客户端据此判断要不要再补全量；不传（或传非数字）即取满 PLAYLIST_MAX","track":"歌词：歌名，必填（客户端把 {track} 替换成 URL 编码后的歌名）","artist":"歌词：歌手，可选；同名多版本时用它消歧","duration":"歌词：时长秒数，可选；填上可进一步消歧（同名曲时长不同时更准）"},"response":{"item":["audioUrl","songmid","media_mid","quality","qualityUrls","url_128","url_320","url_flac","pubtime","coverUrl"],"note":"qualityUrls / url_* 为多音质直链（下载时点选用），缺失时回退 audioUrl；实际档位见每项 quality；pubtime 为发行时间（秒，上游给出时才有）；songmid 为源内曲目 id（客户端拿来走 /aurora/track 复取地址），media_mid 为上游媒体 id（与 songmid 不同值时它才决定音频文件）；coverUrl 为空表示该曲目确实没有专辑封面（上游没有，或 mid 非法拼不出地址），顶层 coverFill.filled 回报本次为几条补到了封面","track":{"shape":{"songmid":"源内曲目 id","found":true,"reason":null,"track":{"songmid":"…","title":"歌名","duration":274},"results":[]},"note":"/aurora/track 专用：found=false 表示上游没有这条 id（reason=not-found / missing-id），取到曲目但无直链时 results 为空而 found=true（reason=no-rights / upstream-error）；track 是与直链无关的曲目身份，客户端可用它核对元数据是否同一首"},"lyric":{"shape":{"results":[{"trackName":"歌名","artistName":"歌手","syncedLyrics":"LRC 文本","duration":108}]},"note":"results 为空表示上游确实没有这首的歌词（不是错误），客户端据此显示「暂无歌词」"},"playlist":{"shape":{"name":"歌单标题","songs":[{"title":"歌名","artist":"歌手"}]},"extra":["server","serverName","total","truncated"],"note":"total 为歌单真实曲目数（不受 ?limit= 影响）；返回条数少于 total 时 truncated=true（?limit= 首屏截断与 PLAYLIST_MAX 截断同一口径）"}}}