T2A Large API 接口
GET
/v1/t2a_async该接口支持基于自然语言交互生成回复的能力。接口本身为无状态接口,即单次调用时,模型所接收到的信息量仅为接口传入内容,不涉及业务逻辑,同时模型也不存储您传入的数据。
该接口支持以下功能:
1、支持单次合成最高10000000(1000万)字符输入;
2、支持语调、语速、音量、比特率、采样率相关参数调整特性;
3、支持音频时长、音频大小等返回参数;
4、支持时间戳(字幕)返回,精确到句;
5、支持非法字符检测:非法字符不超过10%(包含10%),音频会正常生成并返回非法字符占比;非法字符超过10%,接口不返回结果(返回报错码),请检测后再次进行请求(非法字符定义:ascii码中的控制符(不含制表符和换行符));
提交长文本语音合成请求后,合成结果在提交之日次日起7天内完成(T+7),音频文件在服务端可保存7天
适用场景:整本书籍语音合成等
调用接口前请确认您的账号已经完成邮箱绑定,后续信息会以邮件的方式发送给您。
请求参数
text字段备注
上传文件为压缩格式文件,压缩内文件支持TXT/json文件(压缩包内为同一格式文件)
json里会有三个字段,["title", "content", "extra"],分别是标题,正文,作者的话,需要产出三份结果,一共9个文件放在一个文件夹里。如果某字段不存在,或者内容为空,则不生成相应文件
返回参数
语音合成完成后,会返回邮件至您账号绑定的邮箱,请通过邮件中接口进行下载,邮件中链接有效期为任务完成之日起7天(自然日),为了保证您的信息安全,每次点击后获取的下载链接有效期为1小时,请您在有效时间内进行下载,如因为特殊原因无法进行下载或下载失败请及时联系对应的商务经理或直接发送截图回复本邮件。如过期本次下载任务将失效,请您尽快完成下载。
返回文件备注
输入文件(压缩包内) | 字段 | 输出文件 | 备注 |
---|---|---|---|
txt | 无 | 音频mp3 | 此文件的mp3文件 |
字幕json | 字幕json,精确到句 | ||
额外信息json | 参考下列字段 | ||
json | title | 音频mp3 | 字段若或为空信息,则不产生相关内容,其他内容参考txt备注 |
字幕json | |||
额外信息.json | |||
content | 音频mp3 | ||
字幕json | |||
额外信息json | |||
extra | 音频mp3 | ||
字幕json | |||
额外信息.json |
json里会有三个字段,["title", "content", "extra"],分别是标题,正文,作者的话,需要产出三份结果,一共9个文件放在一个文件夹里。如果某字段不存在,或者内容为空,则不生成相应文件。
额外信息字段
参数 | 语义 | 类型 | 备注 |
---|---|---|---|
audio_length | 音频时长 | int64 | 音频时长,精确到毫秒 |
audio_sample_rate | 采样率 | int64 | 默认为24000,如客户请求参数进行调整,会根据请求参数生成 |
audio_size | 音频大小 | int64 | 单位为字节 |
bitrate | 比特率 | int64 | 默认为168000,如客户请求参数进行调整,会根据请求参数生成 |
word_count | 可读字数 | int64 | 已经发音的字数统计(不算标点等其他符号,包含汉字数字字母) |
invisible_character_ratio | 非法字符占比 | float64 | 非法字符不超过10%(包含10%),音频会正常生成并返回非法字符占比;最大不超过0.1(10%),超过进行报错 |
请求失败
参数 | 语义 | 类型 | 备注 |
---|---|---|---|
base_resp | 如果请求出错,对应的错误状态码和详情 | ||
base_resp.status_code | 状态码 | int64 | 1000,未知错误1001,超时1002,触发限流1004,鉴权失败1013,服务内部错误及非法字符超过10%2013,输入格式信息不正常 |
base_resp.status_msg | 错误详情 | string |
请求参数
待合成的文本(打包上传,包里应只包含txt或json文件(压缩包内为同一格式文件))
生成声音的语速(可选,默认值为1.0取值越大,语速越快)
生成声音的音量(可选,默认值为1.0取值越大,音量越高)
生成声音的语调(可选,默认值为0(0为原音色输出,取值需为整数))
生成声音的采样率(可选,默认为32000)
生成声音的比特率(可选,默认值为128000)
示例代码
返回响应
0为成功
{
"task_id": 70012586967104,
"task_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiIxNjg3MjU2NTE5MzAyNDcwIiwiaXNzIjoibWluaW1heCIsInN1YiI6IjcwMDEyNTg2OTY3MTA0In0.abCOG1YKiOU8ka2j2shb60ij8TeT0_9f751DHqbHXjQuEXh6i5pMayKchDUdI8l3-8TdbLoE2wFnLE7gWm7hT9M0-W9ayNm1YFQOmx1sRtDRUObOJp-Y8TUZGFewK0nakXH__F5XCVQYDtInAl-mvx8WI7XbDxFVTu0DWNUPcivd5GqEsr5B9nXj6kRciM5gKmEO_8uv8rzyXWceMpp9J15UFl29yERWdGNX8UfUmx4dSk_M8Z-5rTwEKt8ghb1Yp9QIa0Ier2zgYcxsgv1alRw9GlxVdPv6RMZfFidryENwko0p78g7UwV3x94xmcUMaaprKwJFy_yCCe2RnJVHxQ",
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}