AI MediaKit 视频添加运镜工具能够为静态或平稳拍摄的视频素材一键添加专业的镜头动态效果，如缩放、平移缩放、旋转等，显著提升视频的视觉冲击力和节奏感。此功能常用于素材二次创作、营销片头、短剧动效等场景。本篇开发指南将引导您了解如何通过 API 调用，轻松为您的视频添加运镜效果。 ## 效果预览通过视频加运镜工具，您可以将一段静态的镜头变得充满动感。例如，为一个固定机位的宠物视频添加“缩放”运镜后，画面会平滑地移动和放大，仿佛由专业摄影师进行了运镜操作。 |运镜名称 |效果展示 |描述 | |---|---|---| |视频缩放运镜（`zoom`） |

|模拟镜头向前推进（Zoom In）或向后拉远（Zoom Out）的单一缩放效果。突出主体、强调细节、展示开阔环境。 | |平移缩放运镜（`pan-zoom`） |

|使画面在移动的同时进行放大或缩小，效果更具动感。制作 Ken Burns 特效、让静态图片或视频动起来。 | |360 度旋转运镜（`orbit-360`） |

|模拟镜头围绕一个中心点进行 360 度旋转，创造出强烈的空间感和视觉焦点。强调中心物体、营造眩晕或梦幻感。 | |镜头弹跳运镜（`bounce`） |

|为画面添加富有节奏感的弹跳或轻微震动效果。匹配音乐节拍、制作卡点视频、增加活泼动感。 | ## 快速体验：添加缩放运镜本节将通过一个具体的示例，演示如何调用 API 为一段视频添加缩放（`zoom`）效果。 ### 准备工作 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。 ### 操作流程视频加运镜是一个异步任务，调用 API 的整体流程如下： 1. 成功调用 `POST /api/v1/tools/apply-camera-motion` 提交任务后，您将获得一个唯一的 `task_id`。 2. 您可以通过轮询 `GET /api/v1/tasks/{task_id}` 接口来查询任务状态，直到状态（`status`）变为 `completed`。或者，您也可以配置[事件回调](https://docs.volcengine.com/docs/6448/2288701)自动接收任务状态变化。 3. 任务完成后，解析响应中的 `result` 字段，即可在 `video_url` 字段中获取添加运镜后视频的下载地址。 #### 第 1 步：提交任务您需要调用[提交视频添加运镜任务 API](https://docs.volcengine.com/docs/6448/2488165)。可直接复制以下 cURL 命令提交。该示例将为视频添加“缩放运镜”效果。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/apply-camera-motion' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/input_video.mp4", "motion_style": "zoom" }' ```

说明

需替换参数：

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

请将 video_url 的值替换为您自己准备的视频文件 URL。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-apply-camera-motion-123456789", "request_id": "20240521113000ABCDEFG12345" } ``` #### 第 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}' \ -H 'Authorization: Bearer {Your_API_Key}' ```

说明

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

当任务成功完成后，您将收到如下响应。`result` 字段中的 `video_url` 即是添加运镜后视频的下载地址。该地址的有效期为 24 小时，请务必及时下载保存。 ```JSON { "success": true, "task_id": "amk-tool-apply-camera-motion-123456789", "status":"completed", "result": { "video_url": "https://example.volcvideo.com/motion_output.mp4?auth_key=1774504841-...", "resolution": "1080p", "duration": 125.8 }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851, "request_id": "20240521113000ABCDEFG12345" } ``` ## 进阶使用：为指定时间段添加运镜默认情况下，运镜特效会叠加到视频全片。若您只想对视频的某个片段（如高潮、片头）添加运镜，可通过 `start_time` 与 `end_time` 参数指定运镜的起止时间。以下示例演示如何为视频从第 5 秒到第 12.5 秒添加“平移缩放”（`pan-zoom`）运镜效果： ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/apply-camera-motion' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/input_video.mp4", "motion_style": "pan-zoom", "start_time": 5, "end_time": 12.5 }' ``` ## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入文件 |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

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

* **分辨率限制**：最高支持 1080p 分辨率。

* **时长限制**：不得超过 5 分钟。 | |输出格式 |输出固定为 MP4 格式，分辨率默认对齐原片。 | ## 相关 API 文档 * [提交视频添加运镜任务 API](https://docs.volcengine.com/docs/6448/2488165) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)