一、前提条件
在使用本功能前，你需完成以下前置操作：
·腾讯云账号注册/登录、开通 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 | 歌曲出现的时间段。 |
具体返回示例：
"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" } ]