更新时间:2024-04-18 GMT+08:00

视频背景音乐识别

功能介绍

背景音乐识别接口用于识别视频的背景音乐,返回背景音乐名称。

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

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

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例
    POST https://image.ap-southeast-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

    服务器遇到了一个未曾预料的状况,导致无法完成对请求的处理。