AI MediaKit 的视频截取动图工具能够从视频文件中按指定时间段截取片段，并生成高品质的动态图片（支持 GIF 或 WebP 格式）。该工具适用于制作精彩片段预览、社交媒体分享素材、产品功能演示动图等场景。本篇开发指南将引导您： * 理解视频截取动图的核心能力与应用场景。 * 快速从一段视频中截取指定时长的动图。 * 学习如何指定输出动图的格式。 ## 快速体验：从视频中截取动图本场景演示如何从一段视频的第 10.5 秒截取到第 15 秒，并生成一个 GIF 格式的动图。 ### 准备工作 1. **获取访问凭证**：在开始之前，请访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备一个待处理的视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ### 操作流程视频截取动图是一个异步任务： 1. 成功调用 `POST /api/v1/tools/extract-animated-image` 后，API 将返回一个任务 ID。 2. 您可以轮询 `GET /api/v1/tasks/{task_id}` ，直到任务状态`status` 变为 `completed`；或者，配置[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析 `result` 字段，即可在 `image_url` 字段处获取最终动图文件的下载地址。 #### 第 1 步：提交任务您需要调用[提交视频截取动图任务 API](https://docs.volcengine.com/docs/6448/2484445)。可直接复制以下 cURL 命令提交。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/extract-animated-image' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {Your_API_Key}' \ --data '{ "video_url": "https://example.com/source_video.mp4", "start_time": 10.5, "end_time": 15.0 }' ```

说明

将 {Your_API_Key} 替换为您的有效 API Key。

将 video_url 替换为您真实的视频文件地址。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-extract-animated-image-1400600", "request_id": "20260325160500A8DE7F57A9B3E17A0FF5" } ``` #### 第 2 步：获取结果您需要轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532)，直到任务状态 `status` 变为 `completed`。 ```Bash curl -X GET 'https://mediakit.cn-beijing.volces.com/api/v1/tasks/{task_id}' \ --header 'Authorization: Bearer {Your_API_Key}' ```

说明

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

当任务成功完成后，您将收到如下响应。`result` 字段是一个 JSON 对象，您可以从其下的 `image_url` 字段获取动图的下载地址（有效期 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-extract-animated-image-1400600", "status":"completed", "result": { "image_url": "https://example.volcvideo.com/animated_output.webp?auth_key=1774612861-...", "duration": 4.5, "resolution": "480p" }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851, "request_id": "20260325160500A8DE7F57A9B3E17A0FF5" } ``` ## 进阶使用 ### 指定输出动图格式默认情况下，生成的动图为 `gif` 格式。您可以通过 `output_format` 参数将其指定为 `webp` 格式，以获得更好的压缩率和画质。 #### 示例：从视频中截取动图并保存为 WebP 文件 ```JSON { "video_url": "https://example.com/my_video.mp4", "start_time": 10.5, "end_time": 15.0, "output_format": "webp" } ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入文件限制 |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **视频格式**：支持 `mp4`, `flv`, `ts`, `avi`, `mov`, `wmv`, `mkv` 等主流视频格式。

* **分辨率**：输入视频最高支持 4K (3840×2160) 分辨率。 | |输出动图限制 |* **时长**：输出动图时长（`end_time` \- `start_time`）不能超过 60 秒。

* **分辨率**：输出动图分辨率最大为 480p。若输入视频分辨率低于 480p，则输出分辨率与输入保持一致。

* **帧率**：输出动图的帧率固定为 15 fps。 | ## 相关 API 文档 * [提交视频截取动图任务 API](https://docs.volcengine.com/docs/6448/2484445) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)