文档首页/ 图像识别 Image/ API参考/ 历史API/ API v1（废弃）/ 乐器识别
更新时间：2025-11-28 GMT+08:00
查看PDF
分享

乐器识别

功能介绍

分析并识别图片中包含的乐器信息，返回乐器的存在性，并给出乐器的具体种类。

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

调用失败时的错误码，具体请参见错误码。

调用成功时无此字段。

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

    服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。
父主题： API v1（废弃）

相关文档