# 乐器识别
#### 功能介绍
分析并识别图片中包含的乐器信息，返回乐器的存在性，并给出乐器的具体种类。
#### URI
URI格式
POST /v1.0/image/classify/instrument
#### 请求消息
请求参数请参见[表1]。
 表1请求参数说明 
| 名称        | 是否必选      | 类型     | 说明                                                                         |
|:---|:---|:---|:---|
| image     | 与url二选一   | String | 图像数据，base64编码，要求base64编码后大小不超过10MB，最短边至少15px，最长边最大4096px，支持JPEG、PNG、BMP格式。 |
| url       | 与image二选一 | String | 图片的URL路径，目前支持对服务授权访问华为云上OBS的URL，华为云上OBS提供的临时授权访问的URL和匿名公开授权的URL。           |
| threshold | 可选        | Float  | 乐器检测阈值。默认值为0.50，取值范围（0\~1），输入非该范围内值算法即取默认值。                                |
   
#### 响应消息
响应参数请参见[表2]。
 表2响应参数说明 
| 名称         | 类型      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| result     | JSON    | 调用成功时为图像标签内容。 调用失败时无此字段。                                                                                                                                                                                                                                                                                                                                                                |
| exist      | Boolean | 乐器检测结果： - true：检测到乐器  - false：没有检测到乐器                                                                                                                                                                                                          |
| detail     | List    | 乐器列表集合。                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| label      | String  | 乐器名称。 当前支持4种乐器检测： - cello：大提琴  - guitar：吉他  - piano：钢琴  - zither：古筝   |
| confidence | Float   | 置信度，取值范围（0\~1）。                                                                                                                                                                                                                                                                                                                                                                                                                                |
| error_code | String  | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-image/image_03_0010.html)。 调用成功时无此字段。                                                                                                                                                                                                                                                                                           |
| error_msg  | String  | 调用失败时的错误信息。 调用成功时无此字段。                                                                                                                                                                                                                                                                                                                                                                   |
   
#### 示例
- 请求示例（方式一：使用图片的BASE64编码）
  ```
  POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/classify/instrument
     
  Request Header:  
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  Request Body:
  {
   "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
    "url": "",
    "threshold":0.80
  }
  ```
  
- 请求示例（方式二：使用图片URL）
  ```
  POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/classify/instrument
     
  Request Header:  
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  Request Body:
  {
    "image":"",
    "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName",
    "threshold":0.78
  }
  ```
  
- 成功响应示例
  ```
  {
    "result": {
      "exist": true,
      "detail": [
        {
          "label": "guitar",
          "confidence": "0.9998"
        }
      ]
    }
  }
  ```
  
- 失败响应示例
  ```
  {
      "error_code": "AIS.0105",
      "error_msg": "Recognize Failed"
  }
  ```
  
 
#### 返回值
- 正常 200
  
- 失败
  
  | 返回值 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  |:---|:---|
  | 400 | - 语义有误，当前请求无法被服务器解析。除非进行修改，否则客户端不应重复提交这个请求。  - 请求参数有误。   |
  | 401 | 当前请求需要用户验证。                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | 403 | 没有操作权限。                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  | 404 | 请求失败，在服务器上未找到请求所希望得到的资源。                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | 500 | 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。                                                                                                                                                                                                                                                                                                                                                                                                              |