Base URL: https://music.rrvenn.cn
请求方式: GET / POST
响应格式: JSON（除 /download 和 /stream 返回二进制流）
| 项目 |
说明 |
| 路径 |
/Song_V1 或 /song |
| 方法 |
GET / POST |
| Content-Type |
application/x-www-form-urlencoded |
请求参数
| 参数 |
类型 |
必填 |
说明 |
url |
string |
✅ |
歌曲 ID 或网易云链接 |
level |
string |
❌ |
音质，默认 lossless |
type |
string |
❌ |
填 json 返回完整 JSON |
音质级别
| 值 |
说明 |
需要会员 |
standard |
标准音质 128kbps |
- |
exhigh |
极高音质 320kbps |
- |
lossless |
无损音质 FLAC |
黑胶 VIP |
hires |
Hi-Res 24bit/96kHz |
黑胶 VIP |
jyeffect |
高清环绕声 |
黑胶 VIP |
sky |
沉浸环绕声 |
黑胶 SVIP |
jymaster |
超清母带 |
黑胶 SVIP |
| 项目 |
说明 |
| 路径 |
/Search 或 /search |
| 方法 |
GET / POST |
| Content-Type |
application/x-www-form-urlencoded |
请求参数
| 参数 |
类型 |
必填 |
说明 |
keyword |
string |
✅ |
搜索关键词 |
limit |
int |
❌ |
返回数量，默认 10，最大 50 |
| 项目 |
说明 |
| 路径 |
/Playlist 或 /playlist |
| 方法 |
GET / POST |
请求参数
| 参数 |
类型 |
必填 |
说明 |
id |
string |
✅ |
歌单 ID 或链接 |
支持格式
1234567890 （直接 ID）https://music.163.com/playlist?id=1234567890
| 项目 |
说明 |
| 路径 |
/Album 或 /album |
| 方法 |
GET / POST |
请求参数
| 参数 |
类型 |
必填 |
说明 |
id |
string |
✅ |
专辑 ID 或链接 |
支持格式
1234567890 （直接 ID）https://music.163.com/album?id=1234567890
| 项目 |
说明 |
| 路径 |
/Download 或 /download |
| 方法 |
GET / POST |
| 响应 |
二进制音频流 |
请求参数
| 参数 |
类型 |
必填 |
说明 |
id |
string |
✅ |
歌曲 ID 或链接 |
quality |
string |
❌ |
音质，默认 lossless |
响应头
Content-Type: audio/flac
Content-Disposition: attachment; filename="歌曲名 - 歌手.flac"
X-Download-Filename: 编码后的文件名
| 项目 |
说明 |
| 路径 |
/stream |
| 方法 |
GET / POST |
| 响应 |
二进制音频流（支持 Range） |
请求参数
| 参数 |
类型 |
必填 |
说明 |
id |
string |
✅ |
歌曲 ID |
level |
string |
❌ |
音质，默认 lossless |
用于 Web 播放器内嵌播放，通过服务器代理避免跨域限制。
| 项目 |
说明 |
| 路径 |
/api/info |
| 方法 |
GET |
| 项目 |
说明 |
| 路径 |
/api/stats |
| 方法 |
GET |
| 认证 |
无需 |
| 项目 |
说明 |
| 页面 |
/admin |
| 方法 |
GET / POST |
| 项目 |
说明 |
| 页面 |
/admin/dashboard |
| 认证 |
Session 登录 |
包含三标签页：总览（实时图表）/ 分析（趋势＋排行）/ 日志（实时调用记录）
| 路径 |
说明 |
/admin/api/stats |
总体统计 |
/admin/api/daily?days=30 |
每日趋势 |
/admin/api/hourly |
今日每小时 |
/admin/api/weekly |
近 7 天汇总 |
/admin/api/endpoints |
接口排行 |
/admin/api/ips |
Top 访问 IP |
/admin/api/breakdown |
接口分布占比 |
/admin/api/logs?limit=50 |
最近调用日志 |
/admin/api/methods |
请求方法分布 |
所有接口在失败时返回：
{
"status": 400,
"message": "错误描述"
}
| HTTP 状态码 |
含义 |
200 |
成功 |
400 |
参数错误 |
403 |
未授权（后台 API） |
404 |
资源不存在 |
500 |
服务器内部错误 |
502 |
上游请求失败 |
# 歌曲
https://music.163.com/song?id=185668
https://music.163.com/#/song?id=185668
185668
# 歌单
https://music.163.com/playlist?id=1234567890
1234567890
# 专辑
https://music.163.com/album?id=1234567890
1234567890
访问 https://music.rrvenn.cn/docs 查看交互式 API 文档，可在线测试所有接口。