获取视频、剧集管理全部数据
通过API接口直接获取视频管理、剧集管理的全部数据，包括M3U8、封面等相关链接。
提示：接口可能会偶尔进行优化，如发现一些参数不生效，需更新到最新版使用。
获取视频列表和剧集列表的数据
#后面为转码设置的apikey，该接口会获取视频管理中转码完成的数据 和 剧集管理的全部数据
Get /api/videolist?apikey=5c20cEga22FgG7f
#支持参数
page, search, time, category, type, status, published, limit, id
基础参数（可独立使用）
type：数据类型，只能传入tv和movie值
- movie：只输出视频管理中转码完成的数据
- tv：只输出剧集管理的数据
- 不传则输出视频管理中转码完成的数据 和 剧集管理的全部数据
page：页数，默认为第1页
limit：每页显示多少个数据，默认20
search：搜索关键词
- 不传type时：同时搜索视频管理的标题(originalname)和剧集管理的标题(title)
- type=movie时：仅搜索视频管理标题
- type=tv时：仅搜索剧集管理标题
category：分类提取
- 不传type时：同时提取视频管理和剧集管理的指定分类数据
- type=movie时：仅提取视频管理的分类数据
- type=tv时：仅提取剧集管理的分类数据
高级参数（必须结合type参数一起使用）
status：视频状态，仅限type=movie时使用
- 可传入：waiting、error、finished、intv
- 不传则默认提取所有数据
published：剧集状态，仅限type=tv时使用
- 可传入：published、waiting
- 不传则默认提取所有数据
time：提取最近多少小时的数据
- 填入数值即可，单位：小时
- 必须配合type使用
id：视频id或剧集id
- 传入视频管理的视频id时：输出该视频所有信息
- 传入剧集管理的剧集id时：输出视频管理中该剧集的所有单集视频
- 必须配合type使用
status详解
由于视频状态过多，这里会把部分状态合并到一个里面进行查询：
waiting：输出等待转码和待审核的视频
- 返回信息status字段为：waiting、审核
error：输出所有转码出错的视频
- 返回信息status字段为：秒切失败、错误：存在相同文件夹、应用重启中断、转码错误、error & failed、生成多音轨视频时出错！
finished：输出转码完成和已发布视频
- 返回信息status字段为：finished、转码完成
intv：输出转码完成并添加进剧集的视频
- 返回信息status字段为：intv
published详解
waiting：输出等待发布的剧集
- 返回信息published字段为：waiting
published：输出已经发布的剧集
- 返回信息published字段为：published
参数组合使用规则
✅ 允许的参数组合
1. 不传type（同时输出视频管理+剧集管理）
可使用参数：search、category、page、limit
示例：
/api/videolist?apikey=5c20cEga22FgG7f&search=教育
/api/videolist?apikey=5c20cEga22FgG7f&category=教育视频
/api/videolist?apikey=5c20cEga22FgG7f&search=数学&category=教育视频
2. type=movie（仅视频管理）
可使用参数：status、search、category、time、id，可任意组合
示例：
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=finished
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=finished&category=教育视频
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&search=数学&category=教育视频&time=24
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&id=视频ID
3. type=tv（仅剧集管理）
可使用参数：published、search、category、time、id，可任意组合
示例：
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=published
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=waiting&category=连续剧
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&search=破冰&published=published&time=48
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&id=剧集ID
❌ 不允许的参数组合
- type=movie + published（movie不支持published参数）
- type=tv + status（tv不支持status参数）
- 不传type + status（status必须配合type=movie使用）
- 不传type + published（published必须配合type=tv使用）
- 不传type + time（time必须配合type使用）
- 不传type + id（id必须配合type使用）
完整使用示例
# 示例1：获取所有数据（视频+剧集）
/api/videolist?apikey=5c20cEga22FgG7f
# 示例2：跨类型搜索"教育"关键词
/api/videolist?apikey=5c20cEga22FgG7f&search=教育
# 示例3：跨类型获取"教育视频"分类的所有内容
/api/videolist?apikey=5c20cEga22FgG7f&category=教育视频
# 示例4：跨类型搜索+分类提取
/api/videolist?apikey=5c20cEga22FgG7f&search=数学&category=教育视频
# 示例5：获取已完成的视频，教育分类，第2页
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=finished&category=教育视频&page=2
# 示例6：获取已发布的剧集，最近24小时
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=published&time=24
# 示例7：搜索包含"破冰"的已发布剧集
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&search=破冰&published=published
# 示例8：获取指定剧集的所有单集
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&id=剧集ID
# 示例9：获取指定视频的详细信息
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&id=视频ID
# 示例10：每页显示50条数据
/api/videolist?apikey=5c20cEga22FgG7f&limit=50&page=1
# 示例11：获取转码错误的视频，最近12小时
/api/videolist?apikey=5c20cEga22FgG7f&type=movie&status=error&time=12
# 示例12：获取等待发布的剧集，连续剧分类
/api/videolist?apikey=5c20cEga22FgG7f&type=tv&published=waiting&category=连续剧
返回数据字段说明
通用字段：
code：状态码，1表示成功，0表示失败msg：返回信息描述page：当前页码pagecount：总页数limit：每页显示的数据条数total：符合条件的数据总数
数据统计字段（仅在不传type或不传id时返回）：
movieCount：视频管理中转码完成的视频数量（不包括已添加进剧集的视频数量）singleEpisodeCount：视频管理中已添加进剧集的视频数量tvCount：剧集管理的剧集数量
说明：
- 当使用
search或category参数且不传type时，singleEpisodeCount为0（已合并到movieCount中统计） movieCount+singleEpisodeCount+tvCount=total
数据类型标识字段（list数组中每条数据都包含）：
datatype：数据类型标识movie：视频管理中转码完成的视频（不包括已添加进剧集的视频）singleEpisode：视频管理中已添加进剧集的视频tv：剧集管理的剧集
其他说明：
- 所有结果按
updateAt时间倒序排列（最新更新的在前） categoryStats：分类统计信息数组
默认返回信息示例（不传type）
# 默认输出：视频管理中转码完成的数据 和 剧集管理全部数据
/api/videolist?apikey=5c20cEga22FgG7f
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 4,
"movieCount": 1,
"singleEpisodeCount": 2,
"tvCount": 1,
"list": [
{
"_id": "6927dc25b57d659e211c7a8a",
"director": [
"冯友薇"
],
"writer": [
"鸟山明",
"冯友薇"
],
"stars": [
"柴田秀胜",
"野泽雅子",
"岛本须美"
],
"country": [
"日本"
],
"tags": [
"喜剧",
"动画",
"奇幻",
"冒险"
],
"published": "waiting",
"title": "七龙珠",
"enTitle": "",
"tcTitle": "",
"originaltitle": "ドラゴンボール",
"aka": "龙珠 / Dragonball",
"year": 1986,
"duration": "25分钟",
"episodescount": "153",
"language": "日语",
"rate": 9.3,
"summary": "很久很久以前，曾流传着这样一个传说...",
"enSummary": "",
"tcSummary": "",
"status": "lianzai",
"zhouqi": "",
"episodes": [
{
"_id": "6927dde2142fdea1e5509909",
"episode": "01",
"movieid": "6927dc33b57d659e211c7b58"
},
{
"_id": "6927dde2142fdea1e550990a",
"episode": "02",
"movieid": "6927ddc9142fdea1e550965c"
}
],
"updateAt": "2025-11-27T05:13:06.637Z",
"createAt": "2025-11-27T05:13:06.637Z",
"poster": "/poster/6927dc25b57d659e211c7a8a/poster.webp",
"poster2": {
"url": "/poster/6927dc25b57d659e211c7a8a/poster2.webp",
"height": 810,
"width": 540
},
"category": "日本动漫",
"datatype": "tv"
},
{
"_id": "6927dc33b57d659e211c7bca",
"director": [
"宫崎骏"
],
"writer": [
"宫崎骏"
],
"stars": [
"胡立成",
"彭昱畅",
"神木隆之介"
],
"country": [
"日本"
],
"tags": [
"剧情",
"动画",
"奇幻"
],
"screenshots": [
"/videos/202511/27/6927dc33b57d659e211c7bca/1.webp",
"/videos/202511/27/6927dc33b57d659e211c7bca/0.webp"
],
"status": "转码完成",
"originalname": "千与千寻",
"size": "68338293",
"m3u8paths": [
{
"_id": "6927dcf0142fdea1e55091ac",
"hd": 20000,
"path": "./public/videos/202511/27/6927dc33b57d659e211c7bca/20000/index.m3u8"
}
],
"updateAt": "2025-11-27T05:10:41.740Z",
"createAt": "2025-11-27T05:10:41.698Z",
"aka": "神隐少女(台) / 千与千寻的神隐",
"banben": "HD",
"duration": "2分钟",
"language": "日语",
"originaltitle": "千と千尋の神隠し",
"poster": "/videos/202511/27/6927dc33b57d659e211c7bca/cover.jpg",
"rate": 9.4,
"summary": "千寻和爸爸妈妈一同驱车前往新家...",
"year": 2001,
"moviepath": "/videos/202511/27/6927dc33b57d659e211c7bca",
"time": "00:02:11",
"previewvideo": "/videos/202511/27/6927dc33b57d659e211c7bca/preview.mp4",
"category": "日本动漫",
"totv": null,
"trym3u8": "/try/6927dc33b57d659e211c7bca.m3u8",
"datatype": "movie"
},
{
"_id": "6927dc33b57d659e211c7b58",
"director": [],
"writer": [],
"stars": [],
"screenshots": [
"/videos/202511/27/6927dc33b57d659e211c7b58/1.webp"
],
"status": "intv",
"originalname": "七龙珠 01",
"size": "2479735",
"m3u8paths": [
{
"_id": "6927dc9a142fdea1e5508e31",
"hd": 20000,
"path": "./public/videos/202511/27/6927dc33b57d659e211c7b58/20000/index.m3u8"
}
],
"updateAt": "2025-11-27T05:09:03.898Z",
"createAt": "2025-11-27T05:07:38.905Z",
"moviepath": "/videos/202511/27/6927dc33b57d659e211c7b58",
"duration": "0分钟",
"time": "00:00:16",
"poster": "/videos/202511/27/6927dc33b57d659e211c7b58/cover.webp",
"totv": "6927dc25b57d659e211c7a8a",
"category": "日本动漫",
"trym3u8": "/try/6927dc33b57d659e211c7b58.m3u8",
"datatype": "singleEpisode"
},
{
"_id": "6927ddc9142fdea1e550965c",
"director": [],
"writer": [],
"stars": [],
"screenshots": [
"/videos/202511/27/6927ddc9142fdea1e550965c/1.webp"
],
"status": "intv",
"originalname": "七龙珠 02",
"size": "2567891",
"m3u8paths": [
{
"_id": "6927dc9a142fdea1e5987u36",
"hd": 20000,
"path": "./public/videos/202511/27/6927ddc9142fdea1e550965c/20000/index.m3u8"
}
],
"updateAt": "2025-11-27T05:08:52.765Z",
"createAt": "2025-11-27T05:07:25.432Z",
"moviepath": "/videos/202511/27/6927ddc9142fdea1e550965c",
"duration": "0分钟",
"time": "00:00:18",
"poster": "/videos/202511/27/6927ddc9142fdea1e550965c/cover.webp",
"totv": "6927dc25b57d659e211c7a8a",
"category": "日本动漫",
"trym3u8": "/try/6927ddc9142fdea1e550965c.m3u8",
"datatype": "singleEpisode"
}
],
"categoryStats": [
{
"分类名称": "未分类",
"电影数量": 0,
"单集数量": 0,
"剧集数量": 0
},
{
"分类名称": "日本动漫",
"电影数量": 1,
"单集数量": 2,
"剧集数量": 1
}
]
}
注意datatype为movie或singleEpisode是来自于视频管理的数据，含有m3u8paths参数，即对应的m3u8信息，且m3u8paths里边的hd参数，320为240P、480为360P、640为480P、1138为640P、1280为720P、1920为1080P、2560为2K、20000为原画，path参数为M3U8路径，需自行移除./public后，拼接下域名就可以使用了。
datatype为tv为剧集信息，没有m3u8paths参数，其分集的m3u8信息可参考下方说明。
关于剧集说明
剧集数据只会返回该剧集详情信息和所有单集的视频id，不会返回其M3U8链接，且episodes数组为集数信息，movieid为对应的视频id，然后可以通过以下方法获取单集的M3U8链接，如下：
1、获取单集的自适应M3U8链接，拼接格式：/movie/auto/ + 视频id + .m3u8
/movie/auto/679f0dd2ce4be83f7186d431.m3u8
2、获取某剧集里所有单集的视频详情信息，包括截图、分辨率M3U8链接等，id为该剧集id。
剧集里面的所有集数的详情信息获取接口：/api/videolist?apikey=5c20cEga22FgG7f&type=tv&id=681983c5a0934b5dad7b0ae7
#接口返回信息如下：
{
"code": 1,
"msg": "数据列表",
"page": 1,
"pagecount": 1,
"limit": 20,
"total": 2,
"movieCount": 0,
"singleEpisodeCount": 2,
"tvCount": 1,
"tvDetail": {
"_id": "6927dc25b57d659e211c7a8a",
"title": "七龙珠",
"originaltitle": "ドラゴンボール",
"year": 1986,
"duration": "25分钟",
"episodescount": "153",
"language": "日语",
"rate": 9.3,
"summary": "很久很久以前，曾流传着这样一个传说...",
"status": "lianzai",
"episodes": [
{
"_id": "6927dde2142fdea1e5509909",
"episode": "01",
"movieid": "6927dc33b57d659e211c7b58"
},
{
"_id": "6927dde2142fdea1e550990a",
"episode": "02",
"movieid": "6927ddc9142fdea1e550965c"
}
],
"poster": "/poster/6927dc25b57d659e211c7a8a/poster.webp",
"category": "日本动漫",
"datatype": "tv"
},
"list": [
{
"_id": "6927dc33b57d659e211c7b58",
"status": "intv",
"originalname": "七龙珠 01",
"size": "2479735",
"m3u8paths": [
{
"_id": "6927dc9a142fdea1e5508e31",
"hd": 20000,
"path": "./public/videos/202511/27/6927dc33b57d659e211c7b58/20000/index.m3u8"
}
],
"moviepath": "/videos/202511/27/6927dc33b57d659e211c7b58",
"duration": "0分钟",
"time": "00:00:16",
"poster": "/videos/202511/27/6927dc33b57d659e211c7b58/cover.webp",
"totv": "6927dc25b57d659e211c7a8a",
"category": "日本动漫",
"trym3u8": "/try/6927dc33b57d659e211c7b58.m3u8",
"datatype": "singleEpisode"
},
{
"_id": "6927ddc9142fdea1e550965c",
"status": "intv",
"originalname": "七龙珠 02",
"size": "2567891",
"m3u8paths": [
{
"_id": "6927dc9a142fdea1e5987u36",
"hd": 20000,
"path": "./public/videos/202511/27/6927ddc9142fdea1e550965c/20000/index.m3u8"
}
],
"moviepath": "/videos/202511/27/6927ddc9142fdea1e550965c",
"duration": "0分钟",
"time": "00:00:18",
"poster": "/videos/202511/27/6927ddc9142fdea1e550965c/cover.webp",
"totv": "6927dc25b57d659e211c7a8a",
"category": "日本动漫",
"trym3u8": "/try/6927ddc9142fdea1e550965c.m3u8",
"datatype": "singleEpisode"
}
],
"categoryStats": []
}
tvDetail为该剧集信息，list为分集列表，可根据剧集里面分集movieid，对应的list里面的_id，对应入库即可。
最后自适应M3U8和分辨率M3U8都可以用，图方便就用自适应M3U8，有其他需求就用分辨率M3U8，不了解自适应M3U8的可参考 ⇒ 传送门。