AI MediaKit 的音量调节与淡入淡出工具，可以帮助您轻松调整视频或音频文件的音量大小，或为其添加平滑的淡入、淡出效果。无论是需要将背景音乐无缝融入视频，还是希望统一不同来源素材的音量，都可以通过简单的 API 调用实现。 ## 工具说明 AI MediaKit 为音量调节和淡入淡出功能提供了独立的 API，但它们都遵循相同的异步任务流程，即“提交任务 \-\> 查询结果”。 |功能 |API 文档 |核心能力 | |---|---|---| |**音量调节** |[提交调整视频音量任务 API](https://docs.volcengine.com/docs/6448/2479074) |调整视频音轨的整体音量，可放大、减小或静音。 | |**声音淡入淡出** |* [提交视频声音淡入淡出任务 API](https://docs.volcengine.com/docs/6448/2479072)

* [提交音频声音淡入淡出任务 API](https://docs.volcengine.com/docs/6448/2479073) |为视频音轨或独立音频文件的开头和结尾添加声音渐强（淡入）或渐弱（淡出）效果。 | ## 准备工作 1. **获取访问凭证**：在开始之前，访问 AI MediaKit 控制台 [API Key 管理页面](https://console.volcengine.com/imp/ai-mediakit/settings)，创建并获取 **AI MediaKit API Key**（用于媒体处理功能鉴权）。 2. **准备视频文件**：准备一个需要处理的视频或音频文件，并将其上传至公网可访问的服务器或[视频点播服务](https://www.volcengine.com/docs/4/2834?lang=zh)中，以获取可供 API 调用的 URL。 ## 场景一：全局音量调整本节将演示如何调用 API 将一个视频的整体音量放大至原来的 2 倍。音量调节是一个异步任务，完整的调用流程如下： 1. 成功调用 `POST /api/v1/tools/adjust-video-volume` 提交任务后，系统将返回一个唯一的 `task_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/2479074)。您可以直接复制以下 cURL 命令提交任务。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/adjust-video-volume' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_video.mp4", "volume": 2.0 }' ```

说明

需替换参数：

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

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

volume 参数说明：

0: 静音

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

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

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

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-adjust-video-volume-123456789", "request_id": "20240522103000ABCDEFG12345" } ``` ### 第 2 步：获取结果由于视频处理需要一些时间，您需要通过轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) 来获取最终结果。 ```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-adjust-video-volume-123456789", "status":"completed", "result": { "video_url": "https://example.volcvideo.com/output_volume.mp4?auth_key=1774504841-...", "resolution": "1080p", "duration": 125.8 }, "expires_at":1785240563, "created_at":1785154101, "finished_at":1785154164, "request_id": "20240522103000ABCDEFG12345" } ``` ## 场景二：为视频添加声音淡入淡出效果本节将演示一个常见的场景：如何为一个视频的开头添加 3 秒的声音淡入，并在结尾添加 5 秒的声音淡出，以使听感更加自然。声音淡入淡出是一个异步任务，完整的调用流程如下： 1. 成功调用 `POST /api/v1/tools/fade-video-audio` 提交任务后，系统将返回一个唯一的 `task_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/2479072)，您可以直接复制以下 cURL 命令发起请求。 ```Bash curl -X POST 'https://mediakit.cn-beijing.volces.com/api/v1/tools/fade-video-audio' \ -H 'Authorization: Bearer {Your_API_Key}' \ -H 'Content-Type: application/json' \ -d '{ "video_url": "https://example.com/your_video.mp4", "fade_in_duration": 3, "fade_out_duration": 5 }' ```

说明

需替换参数：

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

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

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

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

请求成功后，您会收到如下包含 `task_id` 的响应，请保存此 ID 用于后续查询。 ```JSON { "success": true, "task_id": "amk-tool-fade-video-audio-123456789", "request_id": "20240521103000ABCDEFG12345" } ``` ### 第 2 步：获取结果由于视频处理需要一些时间，您需要通过轮询[查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) 来获取最终结果。 ```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-fade-video-audio-123456789", "request_id": "20240521103000ABCDEFG12345", "result": { "video_url": "https://example.volcvideo.com/output_fade.mp4?auth_key=1774504841-...", "resolution": "1080p", "duration": 125.8 }, "expires_at": 1777464650, "created_at": 1777291767, "finished_at": 1777291851 } ```

说明

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

## 相关 API 文档 * [提交调整视频音量任务 API](https://docs.volcengine.com/docs/6448/2479074) * [提交音频声音淡入淡出任务 API](https://docs.volcengine.com/docs/6448/2479073) * [提交视频声音淡入淡出任务 API](https://docs.volcengine.com/docs/6448/2479072) * [查询任务信息 API](https://docs.volcengine.com/docs/6448/2278532) * [事件回调](https://docs.volcengine.com/docs/6448/2288701)