跳到内容

音频转码 ​

更新时间

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

将输入音频转换为其他编码格式、码率与采样率。以离线任务方式运行,支持标准音频转码、极速高清(TSC)音频转码与自适应码率音频。

支持的类型 ​

类型说明
标准音频转码降低码率,并调整编码标准、采样率与声道,以适配终端与网络环境
TSC 音频转码标准音频转码的升级版。根据音频类型做自适应优化,以更低带宽提供更清晰的收听体验
自适应码率音频将输入音频转换为多路不同码率的流,供播放环境按需选择

API 信息 ​

项目取值
服务MPS
API ActionProcessMedia
端点mps.tencentcloudapi.com
API 版本2019-06-12
处理方式异步(下发 TaskId 后查询结果)

鉴权方面,所有 API 统一使用 TC3-HMAC-SHA256(SecretId/SecretKey)签名。签名生成方法请参阅 Quick Start 中的 TokenHub 文档。

请求参数 ​

参数类型必填示例说明
InputInfoObject必填{"Type":"URL","UrlInputInfo":{"Url":"https://example.com/audio.mp3"}}输入媒体。Type 为 URL 或 COS
OutputStorageObject必填{"Type":"COS","CosOutputStorage":{"Bucket":"mybucket-125xxx","Region":"ap-guangzhou"}}输出存储。指定 COS 的 Bucket 与 Region
OutputDirString选填/output/audio/输出目录。必须以 / 开头、以 / 结尾
MediaProcessTask.TranscodeTaskSet.N.DefinitionInteger必填100800转码模板 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

静音包补齐 ​

当音频帧不连续或结尾缺少静音时,可填充静音包。通过 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,或通过完成回调获取。

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