文档中心

AI MediaKit

基础剪辑

视频高斯模糊

AI MediaKit 的视频高斯模糊工具，允许您对视频画面中的一个或多个指定矩形区域应用高斯模糊效果。此功能常用于保护隐私信息（如人脸、证件号码）、遮挡固定的水印或角标等场景。输出的视频为 MP4 格式。

本篇开发指南将引导您了解如何通过 API 调用，为您的视频精准添加模糊效果。

效果预览

通过视频高斯模糊工具，您可以对视频中的特定区域进行动态模糊处理，以达到遮挡信息的目的。

原视频	添加高斯模糊后
Replay Play 00:00 / 00:15 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag	Replay Play 00:00 / 00:15 Live 00:00 Fullscreen Cssfullscreen 1x 2x 1.5x 1x 0.75x 0.5x Click and hold to drag

快速体验：为视频中的指定区域添加模糊

本节将通过一个具体的示例，演示如何调用 API 为一段视频的第 5 秒到第 10.5 秒的指定矩形区域添加高斯模糊效果。

准备工作

操作流程

视频高斯模糊是一个异步任务，调用 API 的整体流程如下：

您可以通过轮询 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 小时，请务必及时下载保存。

进阶使用

定义模糊区域

您可以通过 blur_regions 参数手动指定一个或多个矩形区域进行模糊。blur_regions 是一个数组，最多支持 3 组配置，每组配置（一个 JSON 对象）定义一个模糊区域及其生效的时间段。

每个区域的位置通过其左上角和右下角的坐标来定义，所有坐标值均以像素（pixel）为单位，原点 (0, 0) 为视频画面的左上角。

示例：为视频添加两个模糊区域

以下示例演示了如何为一个视频添加两处高斯模糊效果：