音频转码
本文档参考 Tencent Cloud 官方文档 Audio/Video Transcoding Integration,仅收录音频相关能力。
将输入音频转换为其他编码格式、码率与采样率。以离线任务方式运行,支持标准音频转码、极速高清(TSC)音频转码与自适应码率音频。
支持的类型
| 类型 | 说明 |
|---|---|
| 标准音频转码 | 降低码率,并调整编码标准、采样率与声道,以适配终端与网络环境 |
| TSC 音频转码 | 标准音频转码的升级版。根据音频类型做自适应优化,以更低带宽提供更清晰的收听体验 |
| 自适应码率音频 | 将输入音频转换为多路不同码率的流,供播放环境按需选择 |
API 信息
| 项目 | 取值 |
|---|---|
| 服务 | MPS |
| API Action | ProcessMedia |
| 端点 | mps.tencentcloudapi.com |
| API 版本 | 2019-06-12 |
| 处理方式 | 异步(下发 TaskId 后查询结果) |
鉴权方面,所有 API 统一使用 TC3-HMAC-SHA256(SecretId/SecretKey)签名。签名生成方法请参阅 Quick Start 中的 TokenHub 文档。
请求参数
| 参数 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| 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"}} | 输出存储。指定 COS 的 Bucket 与 Region |
| OutputDir | String | 选填 | /output/audio/ | 输出目录。必须以 / 开头、以 / 结尾 |
| MediaProcessTask.TranscodeTaskSet.N.Definition | Integer | 必填 | 100800 | 转码模板 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 |
静音包补齐
当音频帧不连续或结尾缺少静音时,可填充静音包。通过 StdExtInfo 的 audio_info.enable_mute_audio 值控制。
| 取值 | 行为 |
|---|---|
0 | 不启用(默认值) |
1 | 音频帧不连续时补齐静音包 |
2 | 在第 1 项行为的基础上,连结尾静音一并补齐 |
json
"StdExtInfo" : "{\"audio_info\":{\"enable_mute_audio\":1}}"调用示例
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": 100800,
"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-WorkflowTask-b20a8exxxxxxx1tt110253",
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03"
}使用说明
音频转码按输出文件时长计费。标准转码、TSC 转码、音频专用转码等处理类型的单价各不相同。
查询结果时,可在 DescribeTaskDetail API 中输入 TaskId,或通过完成回调获取。