视频剪辑与动图转换
frame 除了取单帧,还可以写成区间来选取一段内容。配合 fmt,可以完成四类操作:
| 源 | 输出格式 | 操作 |
|---|---|---|
| 视频 | mp4 / mov,或不指定 | 视频剪辑 |
| 视频 | gif / webp / avif / png | 视频转动图 |
| 动图 | gif / webp / avif / png,或不指定 | 截取动图片段 |
| 动图 | mp4 / mov | 动图转视频 |
区间写法
格式:起点:终点,多段用半角逗号分隔,按顺序拼接。
| 源 | 单位 | 区间范围 |
|---|---|---|
| 视频 | 毫秒 | 含起点,不含终点 |
| 动图 | 帧序号,从 1 开始 | 含起点与终点 |
| 写法 | 视频 | 动图 |
|---|---|---|
3000:8000 | 第 3 秒到第 8 秒 | – |
1:10 | – | 第 1 帧到第 10 帧 |
:5000 | 开头到第 5 秒 | 开头到第 5000 帧 |
-3000: | 最后 3 秒 | 倒数第 3000 帧到结尾 |
-5: | 最后 5 毫秒 | 最后 5 帧 |
0:2000,10000:12000 | 两段拼接,共 4 秒 | – |
- 负数表示从末尾倒数;省略起点表示从头开始,省略终点表示直到结尾。
- 终点超出实际长度时自动截到结尾;起点超出实际长度时返回错误。
- 最多 20 段。
视频剪辑
https://example.com/video.mp4?frame=3000:8000
- 逐帧精确,音频同步裁剪。
- 可同时使用
w、h、水印等参数。 - 输出时长(各段之和)至多 60 秒;源视频至多 100 MB。
视频转动图
https://example.com/video.mp4?frame=0:3000&fmt=gif&w=320
| 参数 | 含义 | 默认值 |
|---|---|---|
fps | 帧率,只能低于源视频帧率 | 15 |
w、h | 尺寸。不指定时长边自动限制:GIF 为 480,其余格式为 720 | – |
- 选取的总时长至多 30 秒。
- HDR 视频会自动转换为 SDR 画面。
- 缩放、裁剪、水印、质量等图片参数均可使用。
截取动图片段
https://example.com/anim.gif?frame=1:10
输出仍是动图,可同时用 fmt 转换格式。
动图转视频
https://example.com/anim.gif?fmt=mp4
- 不带
frame即转换整段,带区间则只转换选中的帧。 - 每帧的显示时长与原动图一致。
- 默认编码为 H.264,
vcodec=hevc可改为 HEVC。
动图播放参数
以下参数作用于动图输出:
| 参数 | 含义 | 取值 |
|---|---|---|
loop | 播放次数,0 为无限循环。AVIF 不支持 | 0 ~ 65535 |
reverse | 倒放 | 1 |
skip | 抽帧:每保留 1 帧,丢弃其后 N 帧。总时长不变,体积减小 | 0 ~ 100 |
interval | 统一帧时长,单位毫秒,用于变速 | 10 ~ 60000 |