# 视频背景音乐识别
#### 功能介绍
背景音乐识别接口用于识别视频的背景音乐，返回背景音乐名称。
#### URI
URI格式
POST /v1.0/bgm/recognition
#### 请求消息
请求参数说明请参见[表1]。
 表1请求参数说明 
| 名称  | 是否必选 | 类型     | 说明                                                                                         |
|:---|:---|:---|:---|
| url | 是    | String | 视频的URL路径，目前支持华为云上OBS提供的临时授权访问的URL。 目前支持的视频仅限mp4格式，最大65MB。 |
   
#### 响应消息
响参数说明请参见[表2]。
 表2响应参数说明 
| 名称         | 类型     | 说明                                                                                                                             |
|:---|:---|:---|
| result     | Object | 调用成功时表示调用结果。 调用失败时无此字段。                                                  |
| audio_name | String | 背景音乐名称。                                                                                                                        |
| error_code | String | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-image/image_03_0010.html)。 调用成功时无此字段。 |
| error_msg  | String | 调用失败时的错误信息。 调用成功时无此字段。                                                   |
   
#### 示例
- 请求示例
  ```
  POST https://image.cn-north-1.myhuaweicloud.com/v1.0/bgm/recognition
     
  Request Header:  
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  Request Body:
  {
      "url": "https://BucketName.obs.myhuaweicloud.com/ObjectName"
  }
  ```
  
- 成功响应示例
  ```
  {
     "result": {
        "audio_name": "my heart will go on"
     }
  }
  ```
  
- 失败响应示例
  ```
  {
      "error_code": "AIS.0014",
      "error_msg": "The JSON format of the input data is incorrect."
  }
  ```
  
 
#### 返回值
- 正常 200
  
- 失败
  
  | 返回值 | 说明                                                                                                                                                                                                                                                                                                                      |
  |:---|:---|
  | 400 | - 语义有误，当前请求无法被服务器解析。除非进行修改，否则客户端不应重复提交这个请求。  - 请求参数有误。   |
  | 401 | 当前请求需要用户验证。                                                                                                                                                                                                                                                                                                             |
  | 403 | 没有操作权限。                                                                                                                                                                                                                                                                                                                 |
  | 404 | 请求失败，在服务器上未找到请求所希望得到的资源。                                                                                                                                                                                                                                                                                                |
  | 500 | 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。                                                                                                                                                                                                                                                                                           |