文档中心

AI MediaKit

基础剪辑

视频画面变换

视频画面变换

AI MediaKit 提供一系列视频画面变换工具，允许您通过 API 对视频的空间属性进行灵活调整。这些工具包括：

视频画面翻转：对视频进行水平（左右镜像）或垂直（上下颠倒）的翻转处理。

视频画面旋转：将视频画面整体向左旋转 90 度、向右旋转 90 度或旋转 180 度。

视频画面裁剪：根据指定的像素坐标，从视频画面中裁剪出矩形区域，生成新的视频。

视频画面拼接：将多个视频在水平或垂直方向上拼接成一个新的视频。

所有画面变换工具均为异步任务，遵循统一的 API 调用流程，方便您快速集成。

效果预览

通过画面变换系列工具，您可以轻松实现以下效果：

工具	输入视频	输出视频
视频画面翻转	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	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
视频画面旋转	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	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
视频画面裁剪	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	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
视频画面拼接	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 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	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

快速体验：水平翻转一个视频

本节将通过一个具体的示例，演示如何将一个视频进行水平翻转。

准备工作

获取访问凭证：在开始之前，访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 AI MediaKit API Key。

准备视频文件：准备一个需要翻转的视频文件，并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。

操作流程

视频画面变换是一个异步任务，整体流程如下：

成功调用相应工具的 POST 接口提交任务后，您将获得一个唯一的 task_id。

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

任务完成后，解析响应中的 result 字段，即可获取变换后视频的下载地址。

第 1 步：提交任务

调用提交视频画面翻转任务 API。您可以直接复制以下 cURL 命令，向 API 提交一个视频水平翻转任务。

说明

需替换参数：

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

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

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

第 2 步：获取结果

由于视频处理需要时间，您需要通过轮询查询任务信息 API 来获取最终结果，直到任务状态变为 completed。

说明

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

当任务成功完成后，您将收到如下响应。result 字段中的 video_url 即是翻转后视频的下载地址（默认输出为 MP4 格式，有效期为 24 小时）。

说明

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

参考信息

使用限制

限制项

说明

输入文件限制

文件来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。

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

支持格式：

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

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

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

输入分辨率限制：输入视频最高支持 4K (3840×2160) 分辨率。

处理耗时

处理耗时与视频时长和分辨率正相关。视频越长、分辨率越大，耗时越长。平均 RTF（处理耗时/原片时长）为 1。

相关 API 文档

提交视频画面翻转任务 API

提交视频画面旋转任务 API

提交视频画面裁剪任务 API

提交视频画面拼接任务 API

查询任务信息 API

事件回调

最近更新时间：2026.07.28 20:18:47

这个页面对您有帮助吗？

有用

有用

无用

无用