文档中心

AI MediaKit

基础剪辑

音量调节与淡入淡出

AI MediaKit 的音量调节与淡入淡出工具，可以帮助您轻松调整视频或音频文件的音量大小，或为其添加平滑的淡入、淡出效果。无论是需要将背景音乐无缝融入视频，还是希望统一不同来源素材的音量，都可以通过简单的 API 调用实现。

工具说明

AI MediaKit 为音量调节和淡入淡出功能提供了独立的 API，但它们都遵循相同的异步任务流程，即“提交任务 -> 查询结果”。

功能	API 文档	核心能力
音量调节	提交调整视频音量任务 API	调整视频音轨的整体音量，可放大、减小或静音。
声音淡入淡出	提交视频声音淡入淡出任务 API 提交音频声音淡入淡出任务 API	为视频音轨或独立音频文件的开头和结尾添加声音渐强（淡入）或渐弱（淡出）效果。

准备工作

获取访问凭证：在开始之前，访问 AI MediaKit 控制台 API Key 管理页面，创建并获取 AI MediaKit API Key（用于媒体处理功能鉴权）。

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

场景一：全局音量调整

本节将演示如何调用 API 将一个视频的整体音量放大至原来的 2 倍。

音量调节是一个异步任务，完整的调用流程如下：

成功调用 POST /api/v1/tools/adjust-video-volume 提交任务后，系统将返回一个唯一的 task_id。

您可以通过轮询 GET /api/v1/tasks/{task_id} 接口来查询任务状态，直到状态（status）变为 completed；或者使用事件回调自动接收任务状态变化。

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

第 1 步：提交任务

您需要调用提交调整视频音量任务 API。您可以直接复制以下 cURL 命令提交任务。

说明

需替换参数：

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

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

volume 参数说明：

0: 静音

1：保持原音量（默认值）

0 到 1 之间：减小音量（例如 0.5 表示音量减半）

大于 1: 放大音量（例如 2.0 表示音量加倍，最大支持 4.0）

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

第 2 步：获取结果

由于视频处理需要一些时间，您需要通过轮询查询任务信息 API 来获取最终结果。

说明

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

当任务成功完成后，您将收到如下响应。result 字段中的 video_url 即是处理后视频的下载地址，有效期为 24 小时，请及时保存。

场景二：为视频添加声音淡入淡出效果

本节将演示一个常见的场景：如何为一个视频的开头添加 3 秒的声音淡入，并在结尾添加 5 秒的声音淡出，以使听感更加自然。

声音淡入淡出是一个异步任务，完整的调用流程如下：

成功调用 POST /api/v1/tools/fade-video-audio 提交任务后，系统将返回一个唯一的 task_id。

您可以通过轮询 GET /api/v1/tasks/{task_id} 接口来查询任务状态，直到状态 status 变为 completed；或者使用事件回调自动接收任务状态变化。

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

第 1 步：提交任务

调用提交视频声音淡入淡出任务 API，您可以直接复制以下 cURL 命令发起请求。

说明

需替换参数：

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

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

fade_in_duration：声音淡入的时长（秒）。

fade_out_duration：声音淡出的时长（秒）。

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

第 2 步：获取结果

由于视频处理需要一些时间，您需要通过轮询查询任务信息 API 来获取最终结果。

说明

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

当任务成功完成后，您将收到如下响应。result 字段中的 video_url 即是处理后视频的下载地址，有效期为 24 小时，请及时保存。

说明

音频淡入淡出说明：如果您需要处理的是一个独立的音频文件，流程完全相同，只需调用提交音频声音淡入淡出任务 API (/api/v1/tools/fade-audio)，并将参数名从 video_url 换成 audio_url 即可。