AI MediaKit 提供一系列视频画面变换工具，允许您通过 API 对视频的空间属性进行灵活调整。这些工具包括： * **视频画面翻转**：对视频进行水平（左右镜像）或垂直（上下颠倒）的翻转处理。 * **视频画面旋转**：将视频画面整体向左旋转 90 度、向右旋转 90 度或旋转 180 度。 * **视频画面裁剪**：根据指定的像素坐标，从视频画面中裁剪出矩形区域，生成新的视频。 * **视频画面拼接**：将多个视频在水平或垂直方向上拼接成一个新的视频。所有画面变换工具均为异步任务，遵循统一的 API 调用流程，方便您快速集成。 ## 效果预览通过画面变换系列工具，您可以轻松实现以下效果： |工具 |输入视频 |输出视频 | |---|---|---| |视频画面翻转 |

| |视频画面旋转 |

| |视频画面裁剪 |

| |视频画面拼接 |

| ## 快速体验：水平翻转一个视频本节将通过一个具体的示例，演示如何将一个视频进行水平翻转。 ### 准备工作 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` 接口提交任务后，您将获得一个唯一的 `task_id`。 2. 您可以通过轮询 `GET /api/v1/tasks/{task_id}` 来查询任务状态，直到状态 `status` 变为 `completed`。或者，您也可以配置[事件回调](https://docs.volcengine.com/docs/6448/2288701)来自动接收任务完成的通知。 3. 任务完成后，解析响应中的 `result` 字段，即可获取变换后视频的下载地址。 #### 第 1 步：提交任务调用[提交视频画面翻转任务 API](https://docs.volcengine.com/docs/6448/2372087)。您可以直接复制以下 cURL 命令，向 API 提交一个视频水平翻转任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/flip-video' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/orange.mp4", "is_flip_horizontal": true }' ```

说明

需替换参数：

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

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

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-flip-video-123456789", "request_id": "20240520163000ABCDEFG12345" } ``` #### 第 2 步：获取结果由于视频处理需要时间，您需要通过轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) 来获取最终结果，直到任务状态变为 `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` 即是翻转后视频的下载地址（默认输出为 **MP4** 格式，有效期为 24 小时）。 ```JSON { "success": true, "task_id": "amk-tool-flip-video-123456789", "task_type": "flip-video", "status": "completed", "result": { "video_url": "https://example.volcvideo.com/flipped-video.mp4?auth_key=...", "resolution": "1080p", "duration": 65.88 }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851, "request_id": "1742012dcc1938455d84dbe56beb7acc" } ```

说明

所有画面变换工具都遵循上述“提交\-查询”流程，并支持 client_token、callback_url 等通用异步参数。您只需根据需要，替换请求的 Endpoint 和核心参数即可。

## 参考信息 ### 使用限制 |限制项 |说明 | |---|---| |输入文件限制 |* **文件来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **数量限制**：单次任务支持传入 1 到 100 个 URL。

* **支持格式**：

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

* `mp3`, `m4a`, `wav` 等主流音频格式。

* **文件大小**：建议单个输入文件大小不超过 10 GB。

* **输入分辨率限制**：输入视频最高支持 4K (3840×2160) 分辨率。 | ### 处理耗时处理耗时与视频时长和分辨率正相关。视频越长、分辨率越大，耗时越长。平均 RTF（处理耗时/原片时长）为 1。 ## 相关 API 文档 * [提交视频画面翻转任务 API](https://docs.volcengine.com/docs/6448/2372087) * [提交视频画面旋转任务 API](https://docs.volcengine.com/docs/6448/2548045) * [提交视频画面裁剪任务 API](https://docs.volcengine.com/docs/6448/2548043) * [提交视频画面拼接任务 API](https://docs.volcengine.com/docs/6448/2548055) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)