接口咨询 020-3886 5521

竖屏短剧采集接口

竖屏短剧一集 60 到 90 秒,一部戏 60 到 100 集,用长视频那套结构装会散架。竖屏短剧采集接口按“剧—集”两级建索引,单集带 9:16 画面标记、免费集数与付费起点,接进小程序或 H5 后选集顺序不会乱。

棚内摄像机镜头与遮光罩的特写

接口参数

接口版本MacCMS V10 兼容分支,路径 /api/provide/vod/,type_id 走短剧专用段
输出格式JSON(默认),单页 20 部剧,分集在 vod_play_url 内用 # 分隔
单片库配额标准套餐 8 万部剧,按 detail 计次;合集模式按剧计 1 次
字段覆盖36 项,含 vod_ratio(画面比例)、free_episode(免费集数)、vod_total(总集数)
兼容性H5 播放器、小程序 video 组件、竖屏播放壳;分集地址为 m3u8
部署方式公网直连;小程序场景可开 HTTPS 专属入口,证书由我方维护
数据合规剧集元数据与播放地址;付费集仅给地址,不参与任何计费逻辑
SLA 响应播放地址失效率超过 5% 触发批量换源,4 小时内处理
更新间隔新剧上线 10 分钟内可查,在更剧 20 分钟一轮

参数按 竖屏短剧采集接口 的交付口径写,实际配额以控制台显示为准。

三个实际使用场合

小程序首屏的竖屏流

首屏要求一屏一剧、上下滑动切换。接口返回 9:16 封面与首集地址,前端拿到就能播,不用再裁图;单屏加载 1 张封面加 1 个 m3u8,首帧在 4G 网络下约 0.9 秒。

免费集与付费集的切点

一部 80 集的短剧通常前 10 集免费。free_episode 直接给出切点,前端把第 11 集起标“付费”,不用运营一集一集数。

批量上新的排重

同一部剧在两家资源站都有,名字差一个字。按 vod_name 加 vod_total 双键排重,一次导入 300 部能筛掉 40 多部重复。

选型建议

做短剧站先看两个数:单集时长和总集数。时长在 3 分钟以内、总集数 40 集以上的,用竖屏短剧口;如果是每集 30 分钟的横屏“微短剧”,用剧集口更合适,因为它的分集结构和长剧一致。画面比例这件事别将就,9:16 的封面放进 16:9 容器会被裁掉上下,转化率会掉。

客户为什么选这一条,而不是隔壁那家

三条可验证的差异

  • 画面比例单独成字段:vod_ratio 回 9:16 或 16:9,模板按字段切容器,不用靠图片尺寸猜。
  • 免费集数是整数:free_episode 回 10 这样的整数,不是“前十集免费”这种文本。
  • 合集接口按剧计次:一部 80 集的剧只算 1 次调用,按集计次的套餐在短剧场景会贵 6 倍。

交付周期与售后条款

阶段时间与内容
测试 key当天开通,含 200 次试调用
比例与切点核对1 个工作日,抽 20 部剧核对
正式上线第 2 个工作日,可与旧源双跑 5 天

竖屏封面裁切错误按缺陷处理,24 小时内替换;播放地址 403 超过 5% 时批量换源并出报告;不承诺任何剧集的版权归属,使用方自行确认授权范围。

这一类里的其他接口

相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见短剧动漫接口,完整字段说明在对接文档。

常被问到的问题

一部剧有多个版本怎么办

按 vod_id 区分,同名不同版本在 vod_remarks 标“横屏版”“加长版”。

分集地址能直接给小程序吗

能,m3u8 走 HTTPS,域名已配好跨域头。

付费集能不给地址吗

可以按需求过滤,只回免费集地址,付费集留空。