# 声音美化-API接入

一种特定的算法将音频中的声音进行美化。

# 任务创建

根据输入参数创建算法任务并返回任务id

# 请求地址

/v3/pic/ewv/batch

# 请求参数

Method

post

Header

Field	Required	Type	Value	Description
Content-Type	YES	string	application/json
Authorization	YES	string	Basic xxxxxxxxx	用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret)

Body

Field	Son Field	Required	Type	Description
file_link	-	YES	string	音频文件的云存储地址
file_info	-	YES	object	音频文件信息
-	file_size	YES	number	文件大小，单位为字节
-	file_md5	YES	string	音频文件MD5值
-	file_time	YES	number	整数（int）类型音频时长，单位为秒(s)
-	file_ext	YES	string	音频文件格式,wav
voice_type	-	YES	number	均衡器参数，范围[0,22], 默认0
moorer	-	YES	number	是否进行moorer混响, 0 否，1 是, 默认0
file_ext	-	NO	string	需要生成文件格式，只支持mp3,wav，默认mp3
priority	-	YES	integer	优先级, 范围[0,9]

示例代码

{
  "file_link": "pcloud/BR2hWQYXh71660986937000.wav",
  "file_ext": "wav",
  "file_info": {
    "file_size": 10778976,
    "file_md5": "1bf1f1e6f112b2fb5836c1c3abcb5411",
    "file_time": 168,
    "file_ext": "wav"
  },
  "voice_type": 0,
  "moorer": 0,
  "priority": 1
}

# 输入文件限制

音频格式	音频体积	音频长度
MP3 WAV	不超过50 MB

# 返回数据

Body

Field	Son Field	Required	Type	Description
code	-	YES	number	状态码
msg	-	YES	string	请求信息
data	-	YES	object	响应数据
-	task_id	YES	string	任务id

示例代码

{
  "code": 0,
  "msg": "",
  "data": {
    "task_id": "6a4eab77-be30-430a-bf0e-3048042a34ef"
  }
}

# 结果获取

根据任务id 请求任务处理结果

# 请求地址

/v3/pic/ewv/result/{stask_id}

# 请求参数

Method

get

Header

Field	Required	Type	Value	Description
Content-Type	YES	string	application/json
Authorization	YES	string	Basic xxxxxxxxx	用户使用appkey和secret拼接出来的Basic base64(appkey:appsecret)

路径参数

Field	Son Field	Required	Type	Value	Description
task_id	-	YES	string		任务id

# 返回数据

Body

Field	Son Field	Required	Type	Description
code	-	YES	number	状态码
msg	-	YES	string	请求信息
data	-	YES	object	响应数据
-	status	YES	string	任务状态状态：1- 等待中；2-进行中；3-任务完成；4-任务失败；5-任务关闭 6-任务超时 8-余额不足
-	wait_time	YES	string	下一次请求前需要的等待时长，为s为单位
-	voice_result	YES	string	处理后音频下载链接
-	reason	YES	string	失败原因

← 简介简介 →