获取音频、专辑管理全部数据

通过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": []
}