文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>媒体处理>接入教程>媒体 AI 接入>音乐识别接入

音乐识别接入

最近更新时间：2025-10-29 10:23:01

我的收藏

本页目录：

功能介绍

音乐识别功能使用腾讯音乐行业领先的听歌识曲和翻唱识别技术。基于 AI 与大数据的长期研究，技术团队结合 Transformer 架构和音频指纹算法，构建多层级特征网络，能够穿透表象差异，精准解析不同演绎版本作品在演唱者、乐器编配、节奏速度、调式、甚至音乐风格上与原曲的深层关联，实现行业领先的曲库数据规模和识别成功率。

前提条件

在使用本功能前，您需完成以下前置操作：
腾讯云账号注册/登录、开通 MPS 产品、完成服务角色授权。
若您使用腾讯云子账号，还需要保证账号有足够权限使用 MPS 产品。
具体指引请参考 快速入门。账号授权问题可参考 账号授权 文档。

计费说明

腾讯云媒体处理（MPS）音乐识别采用按输入文件时长计费模式，计费规则的完整说明可参考 智能识别原子计费项-音乐识别。

发起音乐识别任务

方式一：使用 API Explorer 快速验证

1. 请前往 媒体处理控制台 开通服务，确认已完成 COS授权。
2. 进入媒体处理 API Explorer 在线调试页面，在左侧接口列表选择 发起媒体处理 接口。参考下图填写输入路径、输出路径、模板 ID 等参数， 在AiAnalysisTask 任务配置中将 Definition 设置为21（预设音乐识别模板）即可指定发起音乐识别任务。ExtendedParameter 为扩展参数，需填写 {"tag":{"process_type":"1102"}}。


方法二：使用 API 发起

上文介绍了如何使用 API Explorer 在线调用接口并调试。您也可以直接向腾讯云发起 POST 请求，接口请求域名：mps.tencentcloudapi.com。发起 POST 请求， definition 为预设音乐识别模板 ID（21），下面为请求的参考范例：
注意：
直接调用 API，在传入 ExtendedParameter 参数时，需要对 JSON 字符串转义。
{
    "InputInfo": {
        "Type": "URL",
        "UrlInputInfo": {
            "Url": "https://data-125xxxxxxx.cos.ap-guangzhou.tencentcos.cn/test/01-%E3%%%B7.mp4"
        //输入文件地址，上述地址实际调用时需替换为可用文件地址
        }
    },
    "OutputStorage": {
        "Type": "COS",
        "CosOutputStorage": {
            "Bucket": "ie-mps-125xxxxxxx",
            "Region": "ap-nanjing"
        }
    },
    "OutputDir": "/common/test/tiger/",
    "AiAnalysisTask": {
        "Definition": 21,
        "ExtendedParameter": "{\\"tag\\":{\\"process_type\\":\\"1102\\"}}"
    },
    "TaskNotifyConfig": {
        "NotifyType": "URL",
        "NotifyUrl": "http://xx.xx.xx.xx:5000//callback"
    }
}

查看回调结果

任务成功发起后，您可以根据回调结果获取音乐识别的歌曲信息。
Tag：歌曲名
SpecialInfo 结构体
字段名
类型
说明
song_name
string
歌曲名称。
album_name
string
专辑名称。
singer_name
string
歌手名。
other_singer_list
array
相关歌手列表。
reference_start
int
歌曲大概起始时间点。
reference_end
int
歌曲大概结束时间点。
segment_list
array
歌曲出现的时间段。
注意：
当回调结果的 TagSet 显示为 []，表示音频片段没有匹配的歌曲。
reference_start，reference_end 仅作参考， 具体的时间范围在 segment_list，由于检测间隔为15秒，因此与乐曲实际持续时间误差≤15s。
具体返回示例：
 "AiAnalysisResultSet": [
        {
            "ClassificationTask": null,
            "CoverTask": null,
            "DeLogoTask": null,
            "DescriptionTask": null,
            "FrameTagTask": null,
            "HeadTailTask": null,
            "HighlightTask": null,
            "HorizontalToVerticalTask": null,
            "SegmentTask": null,
            "TagTask": {
                "BeginProcessTime": "2025-06-13T12:08:20Z",
                "ErrCode": 0,
                "ErrCodeExt": "",
                "FinishTime": "2025-06-13T12:08:57Z",
                "Input": {
                    "Definition": 283568
                },
                "Message": "SUCCESS",
                "Output": {
                    "TagSet": [
                        {
                            "Confidence": 100,
                            "Tag": "繁星",
                            "SpecialInfo": "{\\"song_mid\\": \\"000Quzkn4N0CBN\\", \\"song_id\\": 521340020, \\"reference_start\\": 30, \\"song_name\\": \\"繁星\\", \\"album_name\\": \\"繁星\\", \\"reference_end\\": 255, \\"singer_name\\": \\"袁娅维TIA RAY\\", \\"segment_list\\": [[30, 165], [180, 255]], \\"other_singer_list\\": [{\\"singer_name\\": \\"萧敬腾\\"}]}"
                        }
                    ]
                },
                "Progress": 100,
                "Status": "SUCCESS"
            },
            "Type": "Tag"
        }
    ]
中国站
目录