897812b0796a

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-1416686403.6 KB
资源代理

代理并实时转码外部音频

服务端拉取远程音频 URL,经 ffmpeg 实时转码为 mp3(CBR 320k)后流式返回。用于「不入库直接播放」场景下,外部搜索源返回 webm/opus 等音箱无法解码的直链:客户端把该端点 URL 推给音箱即可播放。复用 /settings/proxy-private-allowlist 做 SSRF 防护;不落盘、不入库、不缓存。ffmpeg 直拉远程 URL,低首字节延迟;并发与 seek/均衡流共享 cap=4,满则 503。ffmpeg 缺失或上游不可解码时返回 503。

get/proxy/transcode

Query parameters

urlstring required

目标音频 URL(URL 编码)

format'mp3'

目标格式,目前仅 mp3

bitrateinteger

目标码率 kbps,默认 320

durationnumber

音频时长(秒),用于设置硬超时;未知可不传

user_agentstring

拉流 User-Agent,缺省用浏览器 UA

refererstring

拉流 Referer

Response

转码后的 mp3 音频流