哼唱识别

功能介绍

分析并识别用户上传的音频文件中哼唱音乐与原唱的相似度，并返回该值。

URI

URI格式

POST /v1.0/audio/humming-recognition

请求消息

响应消息

示例

• 请求示例（方式一：使用音频数据的BASE64编码）

  POST https://image.cn-north-1.myhuaweicloud.com/v1.0/audio/humming-recognition
     
  Request Header:  
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  
  Request Body:
  {
    "data":"cmV0OiAwICAgICAgICAgc3Q6IDAgZmxhZ3M6MSBkdHM6LTIuMDAwMDAwIHB0czogMC4wMDAwMDAgcG9z...",
    "song_name":"夜来香",
    "singer":"邓丽君"
  }  

• 请求示例（方式二：使用音频数据的URL）

  POST https://image.cn-north-1.myhuaweicloud.com/v1.0/audio/humming-recognition
     
  Request Header:  
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  
  Request Body:
  {
    "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName",
    "song_name":"夜来香",
    "singer":"邓丽君"
  }  

• 成功响应示例

  {
    "result": {
      "similarity": 0.72,
    }
  }

• 失败响应示例

  {
      "error_code": "AIS.0105",
      "error_msg": "Recognize Failed"
  }

返回值

• 正常

  200

• 失败

  返回值	说明
  400	语义有误，当前请求无法被服务器解析。除非进行修改，否则客户端不应重复提交这个请求。 请求参数有误。
  401	当前请求需要用户验证。
  403	没有操作权限。
  404	请求失败，在服务器上未找到请求所希望得到的资源。
  500	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。