v56

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

获取歌曲列表

获取歌曲列表,支持按类型过滤、关键词搜索和分页。默认排除隐藏歌单里的歌,传 exclude_playlist_labels=none 显示全部

get/songs

Query parameters

type'local' | 'remote' | 'radio'

歌曲类型

keywordstring

搜索关键词

path_prefixstring

按 file_path 前缀过滤(如 music/Pop)

genrestring

按流派精确过滤

artiststring

按歌手精确过滤

albumstring

按专辑精确过滤

languagestring

按语种精确过滤

stylestring

按风格精确过滤

yearinteger

按发行年份精确过滤

decadeinteger

按年代过滤(起始年,如 1990 匹配 1990-1999)

exclude_playlist_labelsstring

排除属于这些 label 歌单的歌曲(逗号分隔), 默认 hidden; 传 none 显示全部

limitinteger

每页数量

offsetinteger

偏移量

sort'id' | 'title' | 'artist' | 'album' | 'duration' | 'added_at' | 'updated_at' | 'file_modified_at' | 'year' | 'genre'

排序字段,缺省 added_at

order'asc' | 'desc'

排序方向,缺省 desc

Response

成功返回歌曲列表

object required