声音复刻-音色注册(算法编码:8000200005)
协议类型:HTTP
请求方法:POST
一、接入点
| 环境 |
地址 |
| 公网 |
https://api-maas.teleai.com.cn/aipaas/voice/v1/timbre/register |
- API Path:
/aipaas/voice/v1/timbre/register
- 请求方法:
POST
- Content-Type:
application/json
二、鉴权
采用请求头携带鉴权信息:
2.1 标准鉴权
Authorization: <鉴权信息>
| 请求头 |
必填 |
说明 |
Content-Type |
是 |
内容类型,固定 application/json |
X-APP-ID |
否 |
取值为控制台 → 应用及API Key → 创建应用 → AppID |
Device-Uuid |
否 |
设备uuid |
Authorization |
是 |
鉴权信息 |
2.2 Bearer Token 鉴权
Authorization: Bearer <用户申请的API-KEY>
| 请求头 |
必填 |
说明 |
Content-Type |
是 |
内容类型,固定 application/json |
Device-Uuid |
否 |
设备uuid |
Authorization |
是 |
Bearer <API_KEY> |
三、能力简介
声音复刻-音色注册提供整段 10 秒的语音数据的注册接口。注册结果将以 JSON 格式在请求响应中一次性返回,开发者需要保证在注册结果返回之前连接不中断。
四、请求与响应
4.1 请求参数(Json)
| 参数名 |
说明 |
必填 |
类型 |
speaker_id |
全局唯一音色代号 |
是 |
string |
audio_data |
语音数据,经过 base64 编码,要求 base64 编码后大小不超过 2M,音频时长不超过 10 秒 |
是 |
string |
audio_format |
语音数据格式,支持 pcm、wav、mp3,默认 pcm |
是 |
string |
text |
audio_data 所对应的文本,文本应与音频内容对应,并正确使用标点符号 |
否 |
string |
sampling_rate |
audio_data 音频采样率,默认值:16000 Hz。注:音频采样率推荐 24000 Hz,建议不低于 16000 Hz |
否 |
int |
num_channels |
audio_data 音频通道数,默认值:1 |
否 |
int |
4.2 响应体(成功 200,Json Object)
| 参数名 |
说明 |
必填 |
类型 |
code |
状态码 |
是 |
int |
message |
状态说明 |
是 |
string |
speaker_id |
全局唯一音色代号 |
是 |
string |
result |
无意义 |
是 |
object |
注册结果 result
| 参数名 |
说明 |
必填 |
类型 |
result>>cause |
无意义 |
是 |
string |
result>>is_eligible |
无意义 |
是 |
boolean |
4.3 成功示例
{
"code": 10000,
"message": "Success",
"speaker_id": "e0639793-4119-8482-d0ab-01471575c327",
"result": {
"cause": "",
"is_eligible": false
}
}
五、状态码说明
5.1 算法状态码
| 返回码 |
解释 |
说明 |
解决方法 |
10301 |
Required parameter miss |
必填参数缺失 |
检查请求体是否符合接口协议 |
10302 |
Too many requests |
并发请求过多 |
联系商务,增加并发 |
10304 |
Parse request body fail |
请求格式错误 |
查看请求的 URL body 格式是否正确,参考接口文档 |
10503 |
Server connection time out |
服务连接超时 |
联系技术人员 |
10903 |
Register failed |
注册失败 |
联系技术人员 |
10904 |
Audio error |
音频解码失败 |
重新注册 |
10905 |
WER error |
上传音频与对应文本对比字错率过高 |
重新注册 |
10906 |
SNR error |
上传音频的信噪比过低 |
重新注册 |
10907 |
Text error |
上传文本错误 |
重新注册 |
10908 |
Sampling rate error |
采样率错误 |
输入正确的采样率 |
10909 |
Speaker feature error |
特征提取失败 |
联系技术人员 |
10910 |
Audio too long |
音频时间过长 |
换短音频,重新注册 |
10911 |
Database error |
数据库错误 |
联系技术人员 |
10912 |
Abnormal volume |
音量不合适 |
请把音量调到正常范围 |
10000 |
Success |
成功 |
执行下一步操作 |
通用状态码请参考【状态码】中的【网关认证】。
5.2 公共状态码
- 接口响应的公共状态码由网关统一定义,一般用于标识鉴权失败、限流或服务异常,具体业务错误码、错误信息及排查建议请参考:开发指南-公共信息及状态码。
六、调用示例
6.1 请求参数示例
{
"speaker_id": "e0639793-4119-8482-d0ab-01471575c327",
"audio_data": "yourBase64",
"audio_format": "pcm",
"text": "yourText"
}
6.2 Java 版本
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONUtil;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;
/** 主类,用于发起HTTP请求并处理响应 */
public class Example {
public static void main(String[] args) {
example();
}
/**
* 方法中使用到的 JSONUtil、HttpRequest、HttpResponse均来自Hutool工具类。
* 具体maven依赖为:
*
* cn.hutool
* hutool-all
* 5.8.29
*
*/
public static void example() {
try {
String url = "算法调用地址";
// 设置请求头
Map headers = new HashMap();
//调用鉴权
headers.put("Content-Type", "application/json");
headers.put("X-APP-ID", "yourAppId");
headers.put("Authorization", "yourAuthorization");
// 创建请求对象
Map request = new HashMap();
request.put("speaker_id", "e0639793-4119-8482-d0ab-01471575c327");
request.put("audio_data", "yourBase64");
request.put("audio_format", "pcm");
request.put("text", "yourText");
// 将请求对象转换为JsonNode
String requestString = JSONUtil.toJsonStr(request);
// 发起HTTP请求
HttpResponse response =
HttpRequest.post(url)
.headerMap(headers, true)
.body(requestString)
.execute();
// 输出响应结果
System.out.println(response.body());
} catch (Exception e) {
e.printStackTrace();
}
}
}
6.3 Python 版本
import json
import hashlib
import hmac
import time
import re
import urllib.parse
import requests
import warnings
from datetime import datetime
import logging
# 配置日志,设置日志级别为INFO,并指定日志格式
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
# 配置环境变量
X_APP_ID = "yourAppId"
AUTHORIZATION = "yourAuthorization"
# URL 和请求数据
url = "算法调用地址" # 请求的URL
request_data = {
"speaker_id": "e0639793-4119-8482-d0ab-01471575c327",
"audio_data": "yourBase64",
"audio_format": "pcm",
"text": "yourText"
}
# 构建请求头
headers = {
"Content-Type": "application/json",
"X-APP-ID": X_APP_ID,
"Authorization": AUTHORIZATION
}
def timeSimple(timestamp):
# 将时间戳转换为HH:MM:SS格式的时间字符串
dt_object = datetime.fromtimestamp(timestamp)
formatted_time = dt_object.strftime("%H:%M:%S")
return formatted_time
def send_request(url):
try:
start_time = time.time()
logging.info(f"请求路径: {url}")
logging.info(f"开始发送: {timeSimple(start_time)}")
with requests.post(
url, json=request_data, headers=headers, stream=True, verify=False
) as response:
first_packet_time = None
if response.status_code == 200:
logging.info(f"接受到返回: {timeSimple(time.time())}")
for chunk in response.iter_content(chunk_size=1024):
if chunk:
if first_packet_time is None:
first_packet_time = time.time()
logging.info(
f"Received chunk: {timeSimple(time.time())} {chunk.decode('utf-8')}"
)
end_time = time.time()
logging.info(f"Time to first byte (TTFB): {first_packet_time - start_time:.3f} seconds")
logging.info(f"Request completed in {end_time - start_time:.3f} seconds")
else:
logging.error(f"Request failed with status code {response.status_code}")
except Exception as e:
logging.error(f"An error occurred: {e}")
# 发送请求
send_request(url)
logging.info(f"headers = {headers}")