音乐识别
POST
https://cn-east-1.api.xf-yun.com/v1/private/s29ebee0dtext字段Base64解码后示例:(音乐识别)
{
"metadata": {
"timestamp_utc": "2022-06-22 02:42:25",
"music": [{
"play_offset_ms": 59480,
"artists": [{
"name": "张碧晨"
}],
"language": "zh",
"album": {
"name": "光的方向"
},
"label": "华策音乐(天津)有限公司",
"acrid": "22bf590667ed22bfe0c6e0e7e7bf8b8f",
"external_ids": {},
"release_date": "2021-03-31",
"contributors": {
"composers": ["金大洲"],
"lyricists": ["萨吉"]
},
"title": "光的方向(电视剧《长歌行》片头主题曲)",
"external_metadata": {},
"duration_ms": 185000,
"result_from": 3,
"score": 100
}]
},
"cost_time": 0.89600014686584,
"status": {
"msg": "Success",
"version": "1.0",
"code": 0
},
"result_type": 0
}
text字段base64解码后关键信息如下:
参数名 | 类型 | 描述 |
---|---|---|
timestamp_utc | string | 服务端返回时间 ( UTC 时间 ) |
humming | array | 哼唱识别字段 |
music | array | 音乐识别字段 |
play_offset_ms | float | 播放位置 |
artists | array | 歌手字段 |
artists.name | string | 歌手名 |
album | object | 专辑字段 |
album.name | string | 专辑名 |
label | string | 音乐发行版权方 |
external_ids | object | 其他标准码(如 isrc) |
release_date | string | 发行时间 |
contributors | object | 贡献者字段 |
contributors.composers | array | 作曲人名 |
contributors.lyricists | array | 作词人名 |
title | string | 歌曲名 |
external_metadata | object | 第三方平台 id 和 metadata |
duration_ms | float | 歌曲时长 (毫秒) |
result_from | float | 忽略 |
score | float | 识别置信度(满分为100分) |
cost_time | float | 接受数据和响应总时间 |
status | object | 状态信息 |
status.msg | string | 状态详细描述 |
status.version | string | 版本信息 |
status.code | float | 状态信息码 |
请求参数
Body 参数application/json
header
object
必需
协议头部,用于描述平台特性的参数
app_id
string
必需
在平台申请的appid信息
status
integer
必需
请求状态,可选值为:3 (一次性传完)
parameter
object
必需
用于上传服务特性参数
acr_music
object
服务别名
payload
object
必需
输入数据段,携带请求的数据
data
object
输入的音频数据格式
示例
{
"header": {
"app_id": "your_appid",
"status": 3,
},
"parameter": {
"acr_music": {
"mode": "music",
"output_text": {
"encoding": "utf8",
"compress": "raw",
"format": "json"
}
}
},
"payload": {
"data": {
"encoding": "speex-wb",
"sample_rate": 16000,
"channels": 1,
"bit_depth": 16,
"status": 3,
"audio": "SUQzBA......",
"frame_size": 0
}
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
header
object
必需
协议头部,用于描述平台特性的参数
code
integer
必需
返回码,0表示成功,其它表示异常
message
string
错误描述
sid
string
本次会话的id
payload
object
响应数据块
output_text
object
输出数据
示例
{
"header": {
"code": 0,
"message": "success",
"sid": "ase000e1db1@hu17fdeceb15c0207882"
},
"payload": {
"output_text": {
"compress": "raw",
"encoding": "utf8",
"format": "json",
"seq": "0",
"status": "3",
"text": "eyJjb3N0X3Rpb......"
}
}
}
最后修改时间: 1 年前