歌曲管理
随机获取歌曲
与 /songs 共享过滤条件,随机返回 limit 首歌曲完整对象。用于「随机播放」场景。 返回字段与 GET /songs 一致(数组包裹在 songs 字段中),total 为实际返回数量。
get/songs/random
Query parameters
typestring
歌曲类型
keywordstring
搜索关键词
path_prefixstring
按 file_path 前缀过滤
genrestring
按流派精确过滤
artiststring
按歌手精确过滤
albumstring
按专辑精确过滤
languagestring
按语种精确过滤
stylestring
按风格精确过滤
yearinteger
按发行年份精确过滤
decadeinteger
按年代过滤(起始年,如 1990 匹配 1990-1999)
exclude_playlist_labelsstring
排除属于这些 label 歌单的歌曲(逗号分隔), 默认 hidden; 传 none 显示全部
limitinteger
随机返回数量,默认 50,上限 500
Response
成功返回随机歌曲列表
object required