v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
歌曲管理

获取歌曲歌词

根据 song.ID 返回 LyricPayload JSON,含 lyric/tlyric/rlyric/lxlyric。优先级:旁挂 .lrc 文件 > DB url > DB payload > 歌词搜索插件。manual 歌词不被旁挂覆盖。传 refresh=1 时强制重新抓取:跳过库中自动获取的旧歌词(空/scraped/cached)重跑歌词搜索插件,响应挂 no-store 不缓存;file/embedded/manual 等权威歌词不被覆盖。

get/songs/{id}/lyric

Path parameters

idinteger required

歌曲 ID

Query parameters

refreshboolean

为 true 时绕过缓存强制重新抓取歌词(重跑歌词搜索插件,不覆盖 file/embedded/manual 歌词)

Response

LyricPayload

object required