文档中心

AI MediaKit

视频工具

视频横转竖

AI MediaKit 的视频横转竖工具，可将横版视频智能转换为竖版（默认 9:16）成片，输出可直接分发到竖屏平台。工具内部由 AI 完成逐帧主体检测、发言主体识别、主体跟踪与智能裁剪，并对多人场景自动进行布局决策，无需人工编辑即可获得竖屏结果。

本篇开发指南将引导您：

效果预览

输入的横屏视频	输出的竖屏视频
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

快速入门：将横版视频转换为竖版

本节演示如何提交一个视频横转竖任务，将一段 16:9 的横版视频智能转换为 9:16 的竖版成片。

准备工作

准备视频文件：准备一个待处理的横版视频文件，并将其上传至公网可访问的服务器或视频点播服务中，以获取可供 API 调用的 URL。输入应为横屏比例（16:9、4:3、21:9），时长不超过 4 小时，单文件不超过 20 GB。

操作流程

视频横转竖是一个异步任务，其标准流程如下：

您可以轮询 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 小时）。

进阶使用：为竖屏成片烧录外部字幕

如果您希望在竖屏成片中烧录一份外部字幕，可通过 subtitle_url 参数传入一个字幕文件。该字幕仅用于成片阶段烧录字幕，不参与主体识别、跟踪、裁剪等内部处理。字幕文件支持 SRT、ASS 等格式。

参考信息

计费说明

视频横转竖按输出视频时长计量计费，单价为 0.3 元/分钟。关于详细的计费规则与示例，请参阅视频横转竖（按输出时长计费）。

使用限制

限制项	说明
输入视频限制	视频来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：MP4、MOV、MKV、AVI、FLV。画面比例：输入应为横屏比例，支持 16:9、4:3、21:9。视频时长：不超过 4 小时。文件大小：单文件不超过 20 GB。
字幕文件限制	字幕来源：支持公网 HTTP/HTTPS URL、本地上传 (mediakit://)、来源于火山引擎视频点播 (vod://) 和火山引擎对象存储 (tos://) 四种输入协议。关于各协议的具体说明和使用示例，请参阅多源媒体输入与本地上传。支持格式：SRT、ASS 等字幕文件。数量限制：最多传入一个字幕文件。