产品动态
产品公告
音乐识别接入
功能介绍
音乐识别功能使用腾讯音乐行业领先的听歌识曲和翻唱识别技术。基于 AI 与大数据的长期研究，技术团队结合 Transformer 架构和音频指纹算法，构建多层级特征网络，能够穿透表象差异，精准解析不同演绎版本作品在演唱者、乐器编配、节奏速度、调式、甚至音乐风格上与原曲的深层关联，实现行业领先的曲库数据规模和识别成功率。
前提条件
在使用本功能前，您需完成以下前置操作：
腾讯云账号注册/登录、开通 MPS 产品、完成服务角色授权。
若您使用腾讯云子账号，还需要保证账号有足够权限使用 MPS 产品。
计费说明
发起音乐识别任务
方法一：使用API Explorer 快速验证
2. 进入媒体处理 API Explorer 在线调试页面，在左侧接口列表中选择
ProcessMedia 接口。参考下图填写输入路径、输出路径、模板 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"}]
文档反馈