Skip to main content
POST
/
kling
/
v1
/
audio
/
tts
cURL
curl --request POST \
+  --url https://api.deerapi.com/kling/v1/audio/tts \
+  --header 'Authorization: Bearer <DEERAPI_KEY>' \
+  --header 'Content-Type: application/json' \
+  --data '{
    "text": "欢迎来到 DeerAPI Kling 文档站。",
    "voice_id": "chuanmeizi_speech02",
    "voice_language": "zh",
    "voice_speed": 1.0
  }'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_result": {
      "audios": [
        {
          "id": "<string>",
          "url": "<string>",
          "duration": "<string>"
        }
      ]
    }
  }
}
/kling/v1/audio/tts 适合把一段文本快速转成可复用语音,常见于数字人、对口型前置音频、播报和短口播。
先把 voice_idvoice_language 当成一组来选,再去调 voice_speed。首轮不要同时改音色、语种和语速。

快速起步

  • 先从官方音色列表里选定一个 voice_id 和对应语种。
  • 首个请求只保留 textvoice_idvoice_language
  • text 按当前 schema 最长不超过 1000 个字符。
  • 需要更快或更慢的语速时,再补 voice_speed
  • 响应通常可直接从 data.task_result.audios 读取音频结果,但如果还要串下游任务,仍建议保存 task_id
最常见错误不是网关或鉴权,而是 voice_idvoice_language 不匹配。

什么时候不该用这页

相关页面

官方音色 ID 列表

先在这里核对音色 ID 和对应语种。

Kling 数字人创建任务

生成好的语音可以继续喂给数字人口播视频。

对口型创建任务

已有真人视频时,可把 TTS 音频接到对口型流程。

文生音效

需要的是声音氛围而不是人声时改走这里。

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Headers

Content-Type
string

Body

application/json

当前页面不使用 model_name;最常见失败原因是 voice_id 与 voice_language 不匹配。

text
string
default:Hello
required

用于唇形同步视频生成的文本内容。文本内容最大长度为 1000 个字符,超长内容将返回错误码及相关信息。系统会校验文本内容,如有问题将返回错误码及相关信息。

voice_id
string
default:example
required

音色 ID。当 input·mode 参数为 text2video 时,该参数为必填。系统提供多种音色可选。点击此处查看具体音色效果、音色 ID 及对应语种。音色试听不支持自定义脚本。试听文件命名规则:音色名称#音色ID#音色语种。

voice_language
string
default:example
required

音色语种,对应上方的 Voice ID。枚举值:zh,en。当 input·mode 参数为 text2video 时,该参数为必填。音色语种需与 Voice ID 对应。

voice_speed
integer

语速。有效范围:[0.8, 2.0],精确到一位小数,超出范围的值将自动取整。

Response

200 - application/json

语音合成成功,通常可直接从 data.task_result.audios 中读取音频结果。

code
integer
required
message
string
required
request_id
string
required
data
object
required