T2A Large API 接口

该接口支持基于自然语言交互生成回复的能力。接口本身为无状态接口，即单次调用时，模型所接收到的信息量仅为接口传入内容，不涉及业务逻辑，同时模型也不存储您传入的数据。

该接口支持以下功能：

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

curl --location -g --request GET 'http://dev-cn.your-api-server.com/v1/t2a_async?GroupId=${group_id}' \ --header 'authorization: Bearer ${api_key}' \ --form 'model="speech-01"' \ --form 'voice_id="female-tianmei"' \ --form 'text="/Users/minimax/Downloads/21622420008680404 3.zip"' \ --form 'speed="0.8"' \ --form 'vol="1"' \ --form 'pitch="1"' \ --form 'audio_sample_rate="32000"' \ --form 'bitrate="128000"'

{ "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" } }

请求参数

Query 参数

GroupId

string

必需

示例值:

${group_id}

Header 参数

authorization

string

必需

示例值:

Bearer ${api_key}

Body 参数multipart/form-data

model

string

调用的模型版本

必需

示例值:

speech-01

voice_id

string

请求的音色编号

必需

示例值:

female-tianmei

text

string

可选

待合成的文本（打包上传，包里应只包含txt或json文件（压缩包内为同一格式文件））

示例值:

/Users/minimax/Downloads/21622420008680404 3.zip

speed

string

可选

生成声音的语速（可选，默认值为1.0取值越大，语速越快）

示例值:

0.8

vol

string

可选

生成声音的音量（可选，默认值为1.0取值越大，音量越高）

示例值:

pitch

string

可选

生成声音的语调（可选，默认值为0（0为原音色输出，取值需为整数））

示例值:

audio_sample_rate

string

可选

生成声音的采样率（可选，默认为32000）

示例值:

32000

bitrate

string

可选

生成声音的比特率（可选，默认值为128000）

示例值:

128000

application/json

Body

task_id

integer

任务ID

必需

task_token

string

任务密钥

必需

base_resp

object

必需

status_code

integer

状态码

必需

0为成功

status_msg

string

必需

T2A Large API 接口

请求参数#

返回参数#

请求失败#

请求参数

返回响应

请求参数

返回参数

请求失败