文档中心

AI MediaKit

基础剪辑

视频添加运镜

AI MediaKit 视频添加运镜工具能够为静态或平稳拍摄的视频素材一键添加专业的镜头动态效果，如缩放、平移缩放、旋转等，显著提升视频的视觉冲击力和节奏感。此功能常用于素材二次创作、营销片头、短剧动效等场景。

本篇开发指南将引导您了解如何通过 API 调用，轻松为您的视频添加运镜效果。

效果预览

通过视频加运镜工具，您可以将一段静态的镜头变得充满动感。例如，为一个固定机位的宠物视频添加“缩放”运镜后，画面会平滑地移动和放大，仿佛由专业摄影师进行了运镜操作。

运镜名称	效果展示	描述
视频缩放运镜（zoom）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	模拟镜头向前推进（Zoom In）或向后拉远（Zoom Out）的单一缩放效果。突出主体、强调细节、展示开阔环境。
平移缩放运镜（pan-zoom）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	使画面在移动的同时进行放大或缩小，效果更具动感。制作 Ken Burns 特效、让静态图片或视频动起来。
360 度旋转运镜（orbit-360）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	模拟镜头围绕一个中心点进行 360 度旋转，创造出强烈的空间感和视觉焦点。强调中心物体、营造眩晕或梦幻感。
镜头弹跳运镜（bounce）	Replay Play 00:00 / 00:00 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	为画面添加富有节奏感的弹跳或轻微震动效果。匹配音乐节拍、制作卡点视频、增加活泼动感。

快速体验：添加缩放运镜

本节将通过一个具体的示例，演示如何调用 API 为一段视频添加缩放（zoom）效果。

准备工作

操作流程

视频加运镜是一个异步任务，调用 API 的整体流程如下：

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

第 1 步：提交任务

您需要调用提交视频添加运镜任务 API。可直接复制以下 cURL 命令提交。该示例将为视频添加“缩放运镜”效果。

说明

需替换参数：

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

第 2 步：获取结果

由于视频处理需要一些时间，您需要轮询查询任务信息 API，直到任务状态 status 变为 completed。

说明

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

当任务成功完成后，您将收到如下响应。result 字段中的 video_url 即是添加运镜后视频的下载地址。该地址的有效期为 24 小时，请务必及时下载保存。

进阶使用：为指定时间段添加运镜

默认情况下，运镜特效会叠加到视频全片。若您只想对视频的某个片段（如高潮、片头）添加运镜，可通过 start_time 与 end_time 参数指定运镜的起止时间。以下示例演示如何为视频从第 5 秒到第 12.5 秒添加“平移缩放”（pan-zoom）运镜效果：

参考信息

使用限制

限制项	说明
输入文件	视频来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：mp4, flv, ts, avi, mov, wmv, mkv 等。分辨率限制：最高支持 1080p 分辨率。时长限制：不得超过 5 分钟。
输出格式	输出固定为 MP4 格式，分辨率默认对齐原片。