跳到内容

音频增强 ​

更新时间

本文档参考 Tencent Cloud 官方文档 Audio/Video Enhancement Integration,仅收录音频相关功能。

去除输入音频的噪声并改善音质。支持人声降噪、音频质量提升、音量均衡。音频分离在单独文档 Audio Separation 中说明。

支持的功能 ​

功能说明
人声降噪去除人声的背景噪声,提升清晰度
音频质量提升改善输入音频的整体音质
音量均衡降低各片段之间的音量差异,保持稳定的收听音量

API 信息 ​

项目值
服务MPS
API ActionProcessMedia
端点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"
      }
    }
  }
}

请求参数 ​

参数类型必填示例说明
InputInfoObject必填{"Type":"URL","UrlInputInfo":{"Url":"https://example.com/audio.mp3"}}输入媒体。Type 为 URL 或 COS
OutputStorageObject必填{"Type":"COS","CosOutputStorage":{"Bucket":"mybucket-125xxx","Region":"ap-guangzhou"}}输出存储
OutputDirString选填/output/audio/输出目录。须以 / 开头并以 / 结尾
MediaProcessTask.TranscodeTaskSet.N.DefinitionInteger必填100910音频增强模板 ID。预设或自定义模板
MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.ContainerString选填m4a输出封装格式。若仅输出音频则为 m4a
MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.CodecString选填aac输出音频编解码器
MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.BitrateInteger选填64输出音频码率(kbps)
MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.SampleRateInteger选填44100输出采样率(Hz)
MediaProcessTask.TranscodeTaskSet.N.OverrideParameter.AudioTemplate.AudioChannelInteger选填2输出声道数
TaskNotifyConfig.NotifyUrlString选填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 文档。其流程与在增强模板中开启分离功能的方式相同。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages