竖屏短剧采集接口
竖屏短剧一集 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,域名已配好跨域头。
付费集能不给地址吗
可以按需求过滤,只回免费集地址,付费集留空。