接口咨询 020-3886 5521

影视资源采集API接口,接进 MacCMS V10 就能用

2026 年 10 月的一次线路割接里,我们把跨省回源的影视资源采集API接口首帧从 3.1 秒压到 0.7 秒,靠的不是换机器,是把回源节点从 2 个挪到 6 个。

JSON 与 XML 双输出43 项字段m3u8 播放串12 条线路

接口地址(可直接粘贴到采集器)

http://api.yingshicaiji.com/api/provide/vod/?ac=list http://api.yingshicaiji.com/api/provide/vod/?ac=detail&pg=1
  • 分类节点28 个
  • 输出字段43 项
  • 跨省首帧中位数0.7 秒
  • 线路状态12 条在线
28个

分类节点,三级路径可直接生成栏目页

43项

输出字段,元数据与播放地址分开给

12条

回源线路,主备切换平均 1.2 秒

0.7秒

跨省首帧实测中位数,取样 120 部片

INTERFACE GROUPS

四组接口,按你站点的内容结构选

片库型站点用综合口,追更型用剧集与短剧口,只缺播放能力的直接用解析转码。

全部 12 个接口
LIBRARY API

综合影视接口

电影、剧集、综艺、纪录片四个片库口,按 MacCMS V10 的 vod 结构输出,一次对接拿到片名、分类、简介、封面与播放地址。

  • 电影按年份、地区、语言三维切分
  • 剧集保留分季分集与集数序号
  • 综艺按栏目归集,单集带时长
查看该分类的 3 个接口
DRAMA & ANIME

短剧动漫接口

竖屏短剧、番剧、AI 漫剧三条产线,单集时长、合集顺序、配音轨与画面比例单独标注,适配 9:16 与 16:9 两种放映容器。

  • 竖屏短剧单集 60 至 90 秒
  • 番剧按季度与集数归集
  • 漫剧标注配音轨与章节
查看该分类的 3 个接口
PLAYBACK PIPELINE

播放解析转码

把采集回来的播放串变成能播的流:HLS 解析、多线路切换、按档位切片转码,三段分开部署,哪一段出问题都能单独回滚。

  • 遵循 RFC 8216 的 HLS 解析
  • 线路失败 3 次自动换源
  • 720P 至 4K 四档转码
查看该分类的 3 个接口
SITE BRIDGE

建站对接服务

已经有机器的站长看这一段:CMS 对接、插件部署、换域名换源,三个动作都按工单走,交付时给配置记录和回滚步骤。

  • 苹果CMS V10 分类绑定与定时采集
  • 插件包上传即用,含日志面板
  • 换源保留旧库,可随时切回
查看该分类的 3 个接口
FIELD MAP

接口字段对照表:同行给什么,我们给什么

这张表是我们自己对接时踩坑踩出来的。左边是 MacCMS V10 原生字段,中间是本站实际返回值,差异写在最后一列。

完整字段说明
字段MacCMS V10 原生本站输出用途说明
vod_id数字 ID,各站自定数字 ID,站内唯一,跨源不冲突做主键、做去重
vod_name片名,可能含全角符号片名,去掉首尾空格与全角标点列表、搜索、排重
vod_sub副标题,多数为空副标题,无值时回空字符串别名检索
type_id分类 ID,各站定义不同分类 ID,另附 type_path 三级路径分类绑定
type_name分类名分类名,与 type_path 同步更新导航与栏目页生成
vod_pic封面,比例不统一16:9 封面,另附 original_pic 竖版卡片与详情页
vod_year年份,可能带“年”字四位年份整数年份筛选
vod_area地区,可能为空地区,空值补“其他”地区筛选
vod_lang语言语言,多值用竖线分隔字幕与配音筛选
vod_remarks备注,写法自由备注,统一为更新至X集/完结/修复状态标识
vod_play_from播放组标识播放组,保持 $$$ 分组播放器识别
vod_play_url播放串播放串,# 分集,$$$ 分组播放地址

字段名保持不变,改动只在取值规范上。已经在跑的采集器不用改字段映射,换接口地址即可。

POPULAR

这周调用量靠前的 6 个接口

按控制台近 7 天的 detail 调用次数排,不含测试密钥。

查看全部
街角影院门头上方的招牌与外立面

电影频道采集接口

按年份、地区、语言切分片库,封面统一 16:9,修复版单独标记。

查看参数与配额
演播室内的摄像机与主播台布光

剧集频道采集接口

剧与集分两级,集数序号双字段校验,追更延迟控制在 10 分钟内。

查看参数与配额
棚内摄像机镜头与遮光罩的特写

竖屏短剧采集接口

按剧与集建索引,带 9:16 画面标记与免费集数切点。

查看参数与配额
光纤配线架上的尾纤与端口

M3U8解析接口

按 RFC 8216 解析索引,代取加密 key,错误码分九类。

查看参数与配额
交换机机架上的网口指示灯

多线路播放器接口

同一部片回 3 到 5 条线路,按首字节时间排序并自动降级。

查看参数与配额
维修台上拆开的电脑主机与工具

苹果CMS对接服务

五处易错配置逐项核对,交付配置记录与回滚步骤。

查看参数与配额
TROUBLESHOOT

对接排障速查表

六个最常被问到的问题,按现象查,不用翻文档。

看完整排障表
现象常见原因处理动作
采集返回空列表接口地址少了 ac=detail,或 pg 超出总页数补 ac=detail,按返回的 pagecount 控制翻页
只收到前 20 条单页固定 20 条,未翻页用 pg 递增,最多取到 pagecount
播到一半 404源站切片地址过期或被防盗链拦截换线路,或走 M3U8 解析接口代取
封面裂图vod_pic 仍是竖版地址改用 16:9 封面字段,卡片按 16:9 容器裁
分类全部堆在一起多个分类绑到了同一个 type_id按 type_path 逐条重绑,先空跑一页核对
入库时间倒挂源站时区与本地差 8 小时统一按 UTC+8 存 vod_time,展示层再格式化
QUOTA

配额怎么算:三种计法,按你的调用形态选

不按片库条数收费,也不按站点数收费。片库再大,只算你实际拉了几次。

BY CALL

按调用次数

按 detail 请求计次,list 请求不计。适合日更量稳定、每天固定采一批的站点。一次全量 3 万条按 3 万次算,增量只算变更条目。

综合口按此计
BY QPS

按并发峰值

按每秒请求数计,不限制总次数。适合播放解析这类高频小请求的场景,200 QPS 的套餐足够支撑日活 2 万的站点。

解析口按此计
BY BANDWITDH

按出口带宽

按月度出口流量计,看 95 峰值带宽。适合自建转码、需要拉取较大回包的场景,1TB 起步,超出部分按阶梯算。

转码口按此计
FAQ

对接前先弄清这 5 件事

平台说明
接口地址是什么格式,能直接用浏览器打开吗

列表地址是 http://接口域名/api/provide/vod/?ac=list,详情加 ac=detail。浏览器能直接打开,返回的是一段 JSON,第一层是 code 与 list 两个键。

采集频率有限制吗,会不会被封 IP

标准套餐按调用次数计,不额外限制频率,但同一 IP 连续请求超过 200 次每秒会排队。需要突发并发就开专属入口,配额按峰值 QPS 算。

返回的播放地址能不能直接播

能,绝大多数是标准 m3u8,个别源站有防盗链,走解析接口代取一次即可。我们不转存切片,只给地址。

有没有试用,试用能看到全部字段吗

有,测试密钥含 500 次调用,字段与正式一致,唯一差别是部分新片会延迟 2 小时入库。

接口地址变更会提前通知吗

会,变更前 7 天在控制台公告,旧地址保留 30 天可用,公告同时发到工单邮箱。