音频增强
本文档参考 Tencent Cloud 官方文档 Audio/Video Enhancement Integration,仅收录音频相关功能。
去除输入音频的噪声并改善音质。支持人声降噪、音频质量提升、音量均衡。音频分离在单独文档 Audio Separation 中说明。
支持的功能
| 功能 | 说明 |
|---|---|
| 人声降噪 | 去除人声的背景噪声,提升清晰度 |
| 音频质量提升 | 改善输入音频的整体音质 |
| 音量均衡 | 降低各片段之间的音量差异,保持稳定的收听音量 |
API 信息
| 项目 | 值 |
|---|---|
| 服务 | MPS |
| API Action | ProcessMedia |
| 端点 | mps.tencentcloudapi.com |
| API 版本 | 2019-06-12 |
| 处理方式 | 异步(获取 TaskId 后查询结果) |
认证方面,所有 API 统一使用 TC3-HMAC-SHA256(SecretId/SecretKey)签名。签名生成方法请参考 Quick Start 的 TokenHub 文档。
工作原理
音频增强基于转码实现。创建增强模板时通过 EnhanceConfig.AudioEnhance 开启降噪,提交任务时在 Definition 中指定该模板 ID。增强模板创建示例如下。
json
{
"Container": "m4a",
"Name": "audio-denoise",
"AudioTemplate": {
"Codec": "aac",
"Bitrate": 64
},
"EnhanceConfig": {
"AudioEnhance": {
"Denoise": {
"Switch": "ON"
}
}
}
}请求参数
| 参数 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| InputInfo | Object | 必填 | {"Type":"URL","UrlInputInfo":{"Url":"https://example.com/audio.mp3"}} | 输入媒体。Type 为 URL 或 COS |
| OutputStorage | Object | 必填 | {"Type":"COS","CosOutputStorage":{"Bucket":"mybucket-125xxx","Region":"ap-guangzhou"}} | 输出存储 |
| OutputDir | String | 选填 | /output/audio/ | 输出目录。须以 / 开头并以 / 结尾 |
| MediaProcessTask.TranscodeTaskSet.N.Definition | Integer | 必填 | 100910 | 音频增强模板 ID。预设或自定义模板 |
| MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.Container | String | 选填 | m4a | 输出封装格式。若仅输出音频则为 m4a |
| MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.Codec | String | 选填 | aac | 输出音频编解码器 |
| MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.Bitrate | Integer | 选填 | 64 | 输出音频码率(kbps) |
| MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.SampleRate | Integer | 选填 | 44100 | 输出采样率(Hz) |
| MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.AudioChannel | Integer | 选填 | 2 | 输出声道数 |
| TaskNotifyConfig.NotifyUrl | String | 选填 | https://example.com/callback | 任务完成回调 URL。NotifyType 为 URL |
调用示例
python
import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.mps.v20190612 import mps_client, models
cred = credential.Credential("<SecretId>", "<SecretKey>")
http_profile = HttpProfile
http_profile.endpoint = "mps.tencentcloudapi.com"
client = mps_client.MpsClient(cred, "ap-guangzhou", ClientProfile(httpProfile=http_profile))
params = {
"InputInfo": {
"Type": "URL",
"UrlInputInfo": {"Url": "https://example.com/audio.mp3"}
},
"OutputStorage": {
"Type": "COS",
"CosOutputStorage": {"Bucket": "mybucket-125xxx", "Region": "ap-guangzhou"}
},
"OutputDir": "/output/audio/",
"MediaProcessTask": {
"TranscodeTaskSet": [{
"Definition": 100910,
"OverrideParameter": {
"Container": "m4a",
"AudioTemplate": {
"Codec": "aac",
"Bitrate": 64,
"SampleRate": 44100,
"AudioChannel": 2
}
}
}]
}
}
req = models.ProcessMediaRequest
req.from_json_string(json.dumps(params))
resp = client.ProcessMedia(req)
print(resp.to_json_string)响应示例
json
{
"TaskId": "24000022-ScheduleTask-774f101xxxxxxx1tt110253",
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}使用说明
音频增强基于转码实现,因此一个增强任务会同时收取增强费用与转码费用。
如需音频分离,请参考 Audio Separation 文档。其流程与在增强模板中开启分离功能的方式相同。