v56

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

更新歌曲歌词

更新指定歌曲的歌词内容和来源。url 来源传 lyric_remote_url,其它来源传 lyric/tlyric/rlyric/lxlyric 四字段。响应里的 file_write_status 表示是否把元数据回写到本地音频文件:written=已写入,unchanged=未变更(非本地歌曲/无文件路径/不支持的扩展名/url 来源),skipped=标签已一致无需写入,failed=尝试写入但失败(DB 已成功)。lyric_source=manual 用于标记用户手动调整,scanner 重扫时不会覆盖

put/songs/{id}/lyrics

Path parameters

idinteger required

歌曲 ID

Request body

lxlyricstring
lyricstring
lyric_remote_urlstring
lyric_sourcestring
rlyricstring
tlyricstring

Response

更新成功

file_write_statusstring
messagestring