# 声音美化-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 | Value | 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 | Value | 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 | Value | 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 | 失败原因 |