⌘K

Kirin TTS

kirin_tts

Kirin TTS 文本转语音模型,支持通过文本、音色和语速参数合成音频.

认证

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 轮询任务状态接口获取

轮询请求与响应示例见右侧