获取音频、专辑管理全部数据
通过API接口直接获取音频管理、专辑管理的全部数据，包括M3U8等相关链接。
提示：接口可能会偶尔进行优化，如发现一些参数不生效，需更新到最新版使用。
获取音频列表和专辑列表的数据
#后面为转码设置的apikey，该接口会获取音频管理中切片完成的数据 和 专辑管理的全部数据
Get /api/audiolist?apikey=5c20cEga22FgG7f
#支持参数
page, search, time, category, type, status, limit, id
基础参数（可独立使用）
type：数据类型，只能传入album和audio值
- audio：只输出音频管理中切片完成的数据
- album：只输出专辑管理的数据
- 不传则输出音频管理中切片完成的数据 和 专辑管理的全部数据
page：页数，默认为第1页
limit：每页显示多少个数据，默认20
search：搜索关键词
- 不传type时：同时搜索音频管理的标题(title)和专辑管理的标题(title)
- type=audio时：仅搜索音频管理标题
- type=album时：仅搜索专辑管理标题
category：分类提取
- 不传type时：同时提取音频管理和专辑管理的指定分类数据
- type=audio时：仅提取音频管理的分类数据
- type=album时：仅提取专辑管理的分类数据
高级参数（必须结合type参数一起使用）
status：音频状态，仅限type=audio时使用
- 可传入：waiting、error、finished、inalbum
- 不传则默认提取所有数据
time：提取最近多少小时的数据
- 填入数值即可，单位：小时
- 必须配合type使用
id：音频id或专辑id
- 传入音频管理的音频id时：输出该音频所有信息
- 传入专辑管理的专辑id时：输出音频管理中该专辑的所有单集音频
- 必须配合type使用
status详解
waiting：输出等待切片的音频
- 返回信息status字段为：等待切片
error：输出所有切片出错的音频
- 返回信息status字段为：切片失败
finished：输出切片完成的音频
- 返回信息status字段为：切片完成
inalbum：输出切片完成并添加进专辑的音频
- 返回信息status字段为：inalbum
参数组合使用规则
✅ 允许的参数组合
1. 不传type（同时输出音频管理+专辑管理）
可使用参数：search、category、page、limit
示例：
/api/audiolist?apikey=5c20cEga22FgG7f&search=周杰伦
/api/audiolist?apikey=5c20cEga22FgG7f&category=华语音乐
/api/audiolist?apikey=5c20cEga22FgG7f&search=晴天&category=华语音乐
2. type=audio（仅音频管理）
可使用参数：status、search、category、time、id，可任意组合
示例：
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&status=finished
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&status=finished&category=华语音乐
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&search=周杰伦&category=华语音乐&time=24
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&id=音频ID
3. type=album（仅专辑管理）
可使用参数：search、category、time、id，可任意组合
示例：
/api/audiolist?apikey=5c20cEga22FgG7f&type=album
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&category=华语音乐
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&search=周杰伦&time=48
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&id=专辑ID
❌ 不允许的参数组合
- type=album + status（album不支持status参数）
- 不传type + status（status必须配合type=audio使用）
- 不传type + time（time必须配合type使用）
- 不传type + id（id必须配合type使用）
完整使用示例
# 示例1：获取所有数据（音频+专辑）
/api/audiolist?apikey=5c20cEga22FgG7f
# 示例2：跨类型搜索"周杰伦"关键词
/api/audiolist?apikey=5c20cEga22FgG7f&search=周杰伦
# 示例3：跨类型获取"华语音乐"分类的所有内容
/api/audiolist?apikey=5c20cEga22FgG7f&category=华语音乐
# 示例4：跨类型搜索+分类提取
/api/audiolist?apikey=5c20cEga22FgG7f&search=晴天&category=华语音乐
# 示例5：获取已完成的音频，华语音乐分类，第2页
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&status=finished&category=华语音乐&page=2
# 示例6：获取最近24小时的专辑
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&time=24
# 示例7：搜索包含"周杰伦"的专辑
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&search=周杰伦
# 示例8：获取指定专辑的所有单集
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&id=专辑ID
# 示例9：获取指定音频的详细信息
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&id=音频ID
# 示例10：每页显示50条数据
/api/audiolist?apikey=5c20cEga22FgG7f&limit=50&page=1
# 示例11：获取切片错误的音频，最近12小时
/api/audiolist?apikey=5c20cEga22FgG7f&type=audio&status=error&time=12
# 示例12：获取华语音乐分类的专辑
/api/audiolist?apikey=5c20cEga22FgG7f&type=album&category=华语音乐
返回数据字段说明
通用字段：
code：状态码，1表示成功，0表示失败msg：返回信息描述page：当前页码pagecount：总页数limit：每页显示的数据条数total：符合条件的数据总数
数据统计字段（仅在不传type或不传id时返回）：
audioCount：音频管理中切片完成的音频数量（不包括已添加进专辑的音频数量）singleEpisodeCount：音频管理中已添加进专辑的音频数量albumCount：专辑管理的专辑数量
说明：
- 当使用
search或category参数且不传type时，singleEpisodeCount为0（已合并到audioCount中统计） audioCount+singleEpisodeCount+albumCount=total
数据类型标识字段（list数组中每条数据都包含）：
datatype：数据类型标识audio：音频管理中切片完成的音频（不包括已添加进专辑的音频）singleEpisode：音频管理中已添加进专辑的音频album：专辑管理的专辑
其他说明：
- 所有结果按
updateAt时间倒序排列（最新更新的在前） categoryStats：分类统计信息数组
默认返回信息示例（不传type）
# 默认输出：音频管理中切片完成的音频 和 专辑管理全部数据
/api/audiolist?apikey=5c20cEga22FgG7f
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 4,
"audioCount": 1,
"singleEpisodeCount": 2,
"albumCount": 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"
},
{
"_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"
},
{
"_id": "6927ddc9142fdea1e550965c",
"title": "周杰伦精选 02",
"size": "3256847",
"duration": "4:12",
"status": "inalbum",
"m3u8path": "./public/audios/6927ddc9142fdea1e550965c/index.m3u8",
"updateAt": "2025-11-27T05:08:42.156Z",
"createAt": "2025-11-27T05:07:25.432Z",
"toalbum": "6927dc25b57d659e211c7a8a",
"category": "华语音乐",
"datatype": "singleEpisode"
}
],
"categoryStats": [
{
"分类名称": "未分类",
"音频数量": 0,
"单集数量": 0,
"专辑数量": 0
},
{
"分类名称": "华语音乐",
"音频数量": 1,
"单集数量": 2,
"专辑数量": 1
}
]
}
注意datatype为audio或singleEpisode是来自于音频管理的数据，含有m3u8path参数，即对应的m3u8链接，需自行移除./public后，拼接下域名就可以使用了。
datatype为album为专辑信息，没有m3u8path参数，其分集的m3u8信息可参考下方说明。
关于专辑说明
专辑数据只会返回该专辑详情信息和所有单集的音频id，不会返回其M3U8链接，且episodes数组为集数信息，audioid为对应的音频id，然后可以通过以下方法获取单集的M3U8链接，如下：
1、获取单集的M3U8链接，拼接格式：/audios/ + 音频id + /index.m3u8
/audios/6927ddc9142fdea1e550965c/index.m3u8
2、获取某专辑里所有单集的音频详情信息
获取接口，id为专辑id：/api/audiolist?apikey=5c20cEga22FgG7f&type=album&id=6927dc25b57d659e211c7a8a
#接口返回信息如下：
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 2,
"audioCount": 0,
"singleEpisodeCount": 2,
"albumCount": 1,
"albumDetail": {
"_id": "6927dc25b57d659e211c7a8a",
"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"
}
],
"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": []
}
albumDetail为该专辑信息，list为分集列表，可根据专辑里面分集audioid，对应的list里面的_id，对应入库即可。