获取音频、专辑管理全部数据
通过API接口直接获取音频管理、专辑管理的全部数据,包括M3U8等相关链接。
提示:接口可能会偶尔进行优化,如发现一些参数不生效,需更新到最新版使用。
获取音频列表和专辑列表的数据
#后面为转码设置的apikey,该接口会获取音频管理和专辑管理全部数据
Get /api/audiolist?apikey=5c20cEga22FgG7f
#支持参数page, search, time, category, type,status
#可选参数
type:只能传入album和audio值,且audio只输出音频管理的数据、album只输出专辑管理的数据,如不传递则输出音频管理和专辑管理全部数据
page:页数,默认为第1页
limit:每页显示多少个数据,默认20
#可选参数,且以下参数必须结合type参数一起使用
status:音频状态,仅限音频管理使用,可传入waiting、error、finished、inalbum,状态详解看后面,如不传入则默认提取所有数据。
search:搜索音频管理或专辑管理标题
time:提取最近多少小时的数据,填入数值就行,单位小时
category:提取指定分类的数据,填入分类名称就行
id:专辑id 或 音频id,传入音频管理的音频id时,会输出该音频所有信息;传入专辑管理的专辑id时,会输出音频管理中该专辑的所有单集音频。
#status详解
waiting:会输出等待切片的音频,返回信息status字段为等待切片。
error:会输出所有切片出错的音频,返回信息status字段为切片失败。
finished:会输出切片完成的音频,返回信息status字段为切片完成。
inalbum:会输出切片完成并添加进专辑的音频,返回信息status字段为inalbum。
参数可以使用1到多个,如:/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&status=finished&category=华语音乐。
#音频管理返回信息如下:
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 2,
"list": [
{
"_id": "6927dc33b57d659e211c7bca",
"title": "周杰伦 - 晴天",
"size": "8338293",
"duration": "4:28",
"status": "切片完成",
"m3u8path": "./public/audios/6927dc33b57d659e211c7bca/index.m3u8",
"updateAt": "2025-11-27T05:10:41.740Z",
"createAt": "2025-11-27T05:10:41.698Z",
"category": "华语音乐",
"toalbum": null,
"datatype": "audio"
},
{
"_id": "6927dc33b57d659e211c7b58",
"title": "周杰伦精选 01",
"size": "2479735",
"duration": "3:45",
"status": "inalbum",
"m3u8path": "./public/audios/6927dc33b57d659e211c7b58/index.m3u8",
"updateAt": "2025-11-27T05:09:03.898Z",
"createAt": "2025-11-27T05:07:38.905Z",
"toalbum": "6927dc25b57d659e211c7a8a",
"category": "华语音乐",
"datatype": "singleEpisode"
}
],
"categoryStats": [
{
"categoryName": "全部音频",
"stats": {
"total": 2,
"waiting": 0,
"error": 0,
"finished": 1,
"inalbum": 1
}
},
{
"categoryName": "华语音乐",
"stats": {
"total": 2,
"waiting": 0,
"error": 0,
"finished": 1,
"inalbum": 1
}
},
{
"categoryName": "欧美音乐",
"stats": {
"total": 0,
"waiting": 0,
"error": 0,
"finished": 0,
"inalbum": 0
}
}
]
}
#专辑管理返回信息如下:
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 1,
"list": [
{
"_id": "6927dc25b57d659e211c7a8a",
"title": "周杰伦精选集",
"author": "周杰伦",
"type": "专辑",
"language": "国语",
"year": 2024,
"episodescount": "15",
"tags": [
"流行",
"华语"
],
"summary": "收录周杰伦经典歌曲15首,包含晴天、稻香等热门单曲...",
"status": "lianzai",
"episodes": [
{
"_id": "6927dde2142fdea1e5509909",
"episode": "01",
"audioid": "6927dc33b57d659e211c7b58"
},
{
"_id": "6927dde2142fdea1e550990a",
"episode": "02",
"audioid": "6927ddc9142fdea1e550965c"
}
],
"updateAt": "2025-11-27T05:13:06.637Z",
"createAt": "2025-11-27T05:13:06.637Z",
"poster": "/poster/6927dc25b57d659e211c7a8a/poster.jpg",
"category": "华语音乐",
"datatype": "album"
}
],
"categoryStats": [
{
"categoryName": "全部专辑",
"stats": {
"total": 1
}
},
{
"categoryName": "华语音乐",
"stats": {
"total": 1
}
},
{
"categoryName": "欧美音乐",
"stats": {
"total": 0
}
}
]
}
注意音频管理的m3u8path参数为M3U8路径,需自行移除./public后,拼接下域名就可以使用了。
关于专辑说明
专辑数据只会返回该专辑详情信息和所有单集的音频id,不会返回其M3U8链接,且episodes数组为集数信息,audioid为对应的音频d,然后可以通过以下方法获取单集的M3U8链接,如下:
1、获取单集的M3U8链接,拼接格式:/audios/ + 音频id + /index.m3u8
/audios/6927ddc9142fdea1e550965c/index.m3u8
2、获取某专辑里所有单集的音频详情信息
获取接口,id为专辑id:/api/audiolist?apikey=5c20cEga22FgG7f&type=album&id=6927dc25b57d659e211c7a8a,获取后再通过对应的视频id入库
#接口返回信息如下:
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 2,
"audioCount": 0,
"singleEpisodeCount": 2,
"albumCount": 1,
"albumDetail": {
"_id": "6927dc25b57d659e211c7a8a",
"count": 0,
"title": "周杰伦精选集",
"author": "周杰伦",
"type": "专辑",
"tags": [
"流行",
"华语"
],
"language": "国语",
"year": 2024,
"episodescount": "15",
"summary": "收录周杰伦经典歌曲15首,包含晴天、稻香等热门单曲...",
"status": "lianzai",
"episodes": [
{
"_id": "6927dde2142fdea1e5509909",
"episode": "01",
"audioid": "6927dc33b57d659e211c7b58"
},
{
"_id": "6927dde2142fdea1e550990a",
"episode": "02",
"audioid": "6927ddc9142fdea1e550965c"
}
],
"updateAt": "2025-11-27T05:13:06.637Z",
"createAt": "2025-11-27T05:13:06.637Z",
"poster": "/poster/6927dc25b57d659e211c7a8a/poster.jpg",
"category": "华语音乐"
},
"list": [
{
"_id": "6927dc33b57d659e211c7b58",
"title": "周杰伦精选 01",
"size": "2479735",
"duration": "3:45",
"status": "inalbum",
"m3u8path": "./public/audios/6927dc33b57d659e211c7b58/index.m3u8",
"updateAt": "2025-11-27T05:09:03.898Z",
"createAt": "2025-11-27T05:07:38.905Z",
"toalbum": "6927dc25b57d659e211c7a8a",
"category": "华语音乐",
"datatype": "singleEpisode"
},
{
"_id": "6927ddc9142fdea1e550965c",
"title": "周杰伦精选 02",
"size": "3256847",
"duration": "4:12",
"status": "inalbum",
"m3u8path": "./public/audios/6927ddc9142fdea1e550965c/index.m3u8",
"updateAt": "2025-11-27T05:10:15.234Z",
"createAt": "2025-11-27T05:08:42.156Z",
"toalbum": "6927dc25b57d659e211c7a8a",
"category": "华语音乐",
"datatype": "singleEpisode"
}
],
"categoryStats": []
}