v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
缓存管理

更新缓存配置

更新服务端音乐缓存的配置,如最大缓存大小和缓存目录。cache_dir 为空字符串时恢复使用默认目录。transcode_format 非空(mp3/m4a/ogg/flac/wav)时,缓存网络歌曲落盘会统一转码为该格式(缺 ffmpeg 或转码失败时保留原格式),transcode_quality 为可选码率(128/192/320,空或非法为最高质量)。更新后会自动触发 LRU 淘汰检查。切换目录时不会自动迁移旧缓存文件。

put/cache-manage/config

Request body

cache_dirstring

自定义缓存目录,空字符串表示使用默认目录

max_sizeinteger

最大缓存大小(字节),0 表示无限制

transcode_formatstring

TranscodeFormat 缓存网络歌曲落盘时统一转码的目标格式(mp3/m4a/ogg/flac/wav)。 空字符串表示不转码、按上游原格式落盘(默认)。缺 ffmpeg 或转码失败时优雅降级保留原格式。

transcode_qualitystring

TranscodeQuality 转码目标码率(128/192/320),空或非法值表示最高质量。仅对有损格式生效。

Response

更新后的缓存配置

cache_dirstring
default_cache_dirstring
max_sizeinteger
transcode_formatstring
transcode_qualitystring