文档中心

AI MediaKit

基础剪辑

视频加图片

AI MediaKit 视频加图片工具，允许您将一张静态图片（如 Logo、二维码、水印或任何装饰性元素）叠加到视频画面的指定位置。您可以精确控制图片的大小、位置以及其在视频中出现的起止时间。

本指南将带您了解如何通过 API 调用，为您的视频添加图片水印。

效果预览

通过视频加图片工具，您可以实现以下效果：

输入视频	输出视频（右上角添加 Logo 后）
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

快速体验：为视频添加右下角 Logo

本节将通过一个具体的示例，演示如何将一个 PNG 格式的 Logo 图片，作为水印添加到视频的右下角，并让它贯穿整个视频。

准备工作

操作流程

视频加图片是一个异步任务，整体流程如下：

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

第 1 步：提交任务

调用提交视频加图片任务 API。您可以直接复制以下 cURL 命令，向 API 提交一个添加水印的任务。该示例将使用默认参数，把图片放在视频的右下角区域。

说明

需替换参数：

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

第 2 步：获取结果

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

说明

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

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

进阶使用

控制水印的显示时长

默认情况下，添加的图片会从视频开始一直显示到结束。您可以利用 start_time 和 end_time 参数，让图片仅在视频的特定时间段内出现。例如，下面的配置将让 Logo 只在视频的第 5 秒到第 15 秒之间显示。