转码切片接口
源站给的码率经常不对版:标 1080P,实际 480P 拉伸。转码切片接口按 720P、1080P、2K、4K 四档重切,统一 6 秒切片、统一 GOP,切完的流在弱网下也不会一卡三秒。
接口参数
| 接口版本 | 任务式接口,POST /job 建任务,GET /job/{id} 查状态 |
|---|---|
| 输出格式 | JSON 任务状态加 m3u8 成品地址,成品存对象存储 |
| 并发配额 | 标准套餐 3 路并发转码,扩容 12 路;按分钟计费 |
| 字段覆盖 | 16 项,含 profile、bitrate、gop、segment_time、progress |
| 兼容性 | 输出标准 HLS,hls.js、Safari、安卓原生均可播 |
| 部署方式 | 云端转码,也可私有化部署(需 GPU 或高主频 CPU) |
| 数据合规 | 转码产物保留 7 天自动清理,源文件不落盘超过 24 小时 |
| SLA 响应 | 任务排队超过 10 分钟给预估时间,失败任务自动重试 2 次 |
| 切片规格 | 切片 6 秒,GOP 固定 60 帧,音频 AAC 128kbps |
参数按 转码切片接口 的交付口径写,实际配额以控制台显示为准。
三个实际使用场合
老片源的统一规格
一批 2010 年前的片源码率在 800kbps 上下,直接播会糊。按 1080P 档重切后平均码率 2.6Mbps,同一批片在 55 寸电视上能看清字幕边缘。
4K 片源的单独队列
4K 转码吃 CPU,跟 720P 抢资源会让整批任务都慢。接口把 4K 单独排队,720P 队列的平均等待从 40 分钟降到 6 分钟。
弱网环境的低码率兜底
地铁场景下用户带宽常低于 1Mbps。额外切一档 480P、900kbps 的流,卡顿率从 31% 降到 9%。
选型建议
先算清账:一小时 1080P 转码约消耗 0.35 核时,按量计费的套餐比自己买机器便宜,除非每月转码量稳定超过 800 小时。另一个判断点是源文件能不能落盘,涉及版权限制的片源只能走不落盘模式,这要求接口支持流式转码而不是先下载再转。
客户为什么选这一条,而不是隔壁那家
三条可验证的差异
- GOP 固定而非自适应:固定 60 帧 GOP 让切片边界稳定,切集时不会出现半帧花屏。
- 任务失败自动重试两次:源站瞬时 502 导致的失败不用人工重跑,重试成功率约 82%。
- 成品 7 天自动清理:不做长期存储,成本压下来,也避免被当成片库使用。
交付周期与售后条款
| 阶段 | 时间与内容 |
|---|---|
| 接口开通 | 当天,含 60 分钟试转码额度 |
| 规格确认 | 1 个工作日,交付档位与码率表 |
| 正式上线 | 第 4 个工作日,可先转 5% 片源 |
转码产物花屏、音画不同步按缺陷处理,24 小时内重转;排队超时按分钟返还额度;不承担源文件本身损坏导致的任务失败。
这一类里的其他接口
相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见播放解析转码,完整字段说明在对接文档。
常被问到的问题
能只转音频吗
能,传 video=0,输出 m4a,用于配音轨场景。
支持 H.265 吗
支持,但部分安卓机型兼容性差,默认给 H.264。
成品能下载吗
能,成品地址带 24 小时签名,过期需重新签发。