AI MediaKit 的视频横转竖工具，可将横版视频智能转换为竖版（默认 9:16）成片，输出可直接分发到竖屏平台。工具内部由 AI 完成逐帧主体检测、发言主体识别、主体跟踪与智能裁剪，并对多人场景自动进行布局决策，无需人工编辑即可获得竖屏结果。本篇开发指南将引导您： * 快速体验如何将一段横版视频转换为竖版成片。 * 掌握在竖屏成片中叠加烧录外部字幕的用法。 ## 效果预览 |输入的横屏视频 |输出的竖屏视频 | |---|---| |

| ## 快速入门：将横版视频转换为竖版本节演示如何提交一个视频横转竖任务，将一段 16:9 的横版视频智能转换为 9:16 的竖版成片。 ### 准备工作 * **获取访问凭证**：在开始之前，请访问 AI MediaKit 控制台的 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **MediaKit API Key**。 * **准备视频文件**：准备一个待处理的横版视频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。输入应为横屏比例（`16:9`、`4:3`、`21:9`），时长不超过 4 小时，单文件不超过 20 GB。 ### 操作流程视频横转竖是一个异步任务，其标准流程如下： 1. 成功调用 `POST /api/v1/tools/reframe-video-to-vertical` 提交任务后，您将获得一个任务 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/6aa0c271ad15a304c42c5e8e)。可直接复制以下 cURL 命令，提交一个将横版视频转换为竖版成片的任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/reframe-video-to-vertical' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://vod-ai-test.tos-cn-beijing.volces.com/demo/ai_mediakit_intro_cn.mp4" }' ```

说明

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

video_url：替换为您自己的横版视频地址。

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-reframe-video-to-vertical-123456789", "request_id": "20260908130000ABCDEFG12345" } ``` #### 第 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-reframe-video-to-vertical-123456789", "request_id": "20260908130000ABCDEFG12345", "status": "completed", "result": { "video_url": "https://example.volcvideo.com/vertical_output.mp4?auth_key=...", "duration": 120.5 }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777292051 } ``` ## 进阶使用：为竖屏成片烧录外部字幕如果您希望在竖屏成片中烧录一份外部字幕，可通过 `subtitle_url` 参数传入一个字幕文件。该字幕仅用于成片阶段烧录字幕，不参与主体识别、跟踪、裁剪等内部处理。字幕文件支持 `SRT`、`ASS` 等格式。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/reframe-video-to-vertical' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_landscape_video.mp4", "subtitle_url": "https://example.com/your_subtitle.srt" }' ``` ## 参考信息 ### 计费说明视频横转竖按**输出视频时长**计量计费，单价为 **0.3 元/分钟**。关于详细的计费规则与示例，请参阅[视频横转竖（按输出时长计费）](https://docs.volcengine.com/docs/6448/2486473#002c9087)。 ### 使用限制 |限制项 |说明 | |---|---| |输入视频限制 |* **视频来源**：支持公网 HTTP/HTTPS URL、本地上传 (`mediakit://`)、来源于火山引擎视频点播 (`vod://`) 和火山引擎对象存储 (`tos://`) 四种输入协议。关于各协议的具体说明和使用示例，请参阅[多源媒体输入与本地上传](https://docs.volcengine.com/docs/6448/2536893)。

* **支持格式**：`MP4`、`MOV`、`MKV`、`AVI`、`FLV`。

* **画面比例**：输入应为横屏比例，支持 `16:9`、`4:3`、`21:9`。

* **视频时长**：不超过 4 小时。

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

* **支持格式**：`SRT`、`ASS` 等字幕文件。

* **数量限制**：最多传入一个字幕文件。 | ## 相关 API 文档 * [提交视频横转竖任务 API](https://docs.volcengine.com/docs/6448/6aa0c271ad15a304c42c5e8e) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)