文档中心

AI MediaKit

基础剪辑

视频截取动图

AI MediaKit 的视频截取动图工具能够从视频文件中按指定时间段截取片段，并生成高品质的动态图片（支持 GIF 或 WebP 格式）。该工具适用于制作精彩片段预览、社交媒体分享素材、产品功能演示动图等场景。

本篇开发指南将引导您：

快速体验：从视频中截取动图

本场景演示如何从一段视频的第 10.5 秒截取到第 15 秒，并生成一个 GIF 格式的动图。

准备工作

获取访问凭证：在开始之前，请访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 AI MediaKit API Key（用于媒体处理功能鉴权）。

操作流程

视频截取动图是一个异步任务：

您可以轮询 GET /api/v1/tasks/{task_id} ，直到任务状态status 变为 completed；或者，配置事件回调自动接收任务状态变化。

第 1 步：提交任务

您需要调用提交视频截取动图任务 API。可直接复制以下 cURL 命令提交。

说明

请求成功后，您会收到如下包含 task_id 的响应，请保存此 ID 用于后续查询。

第 2 步：获取结果

您需要轮询查询任务信息 API，直到任务状态 status 变为 completed。

说明

将 URL 末尾的 {task_id} 替换为第 1 步返回的任务 ID。

当任务成功完成后，您将收到如下响应。result 字段是一个 JSON 对象，您可以从其下的 image_url 字段获取动图的下载地址（有效期 24 小时）。

进阶使用

指定输出动图格式

默认情况下，生成的动图为 gif 格式。您可以通过 output_format 参数将其指定为 webp 格式，以获得更好的压缩率和画质。

示例：从视频中截取动图并保存为 WebP 文件

参考信息

使用限制

限制项	说明
输入文件限制	视频来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。视频格式：支持 mp4, flv, ts, avi, mov, wmv, mkv 等主流视频格式。分辨率：输入视频最高支持 4K (3840×2160) 分辨率。
输出动图限制	时长：输出动图时长（end_time - start_time）不能超过 60 秒。分辨率：输出动图分辨率最大为 480p。若输入视频分辨率低于 480p，则输出分辨率与输入保持一致。帧率：输出动图的帧率固定为 15 fps。