认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
值: kirin_tts
text string 必填
合成音频的文案
文本内容最大长度 1000 个字符,内容过长会返回错误码等信息。
系统会校验文本内容,如有问题会返回错误码等信息。
voice_id string 必填
音色 ID
系统提供多种音色可供选择。音色 ID 与音色语种对应,需与 voice_language 参数匹配。
音色试听不支持自定义文案。
音色试听文件命名规范:音色名称#音色ID#音色语种
voice_language string 必填
音色语种
默认值:zh
枚举值:zh, en
音色语种与音色 ID 对应。
voice_speed float
语速
默认值:1.0
有效范围:0.8 - 2.0
精度:小数点后 1 位,超出部分将自动四舍五入。
callback_url string
回调 URL
external_task_id string
自定义任务 ID, 传入不会覆盖系统生成的任务 ID, 但支持通过该 ID 进行任务查询
注:单用户下需要保证唯一性
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧