POST/kling/v1/audio/tts

语音合成

API Key application/json

Request

请求

/kling/v1/audio/tts

Body

必填

Bodyobject

textstring必填

合成音频的文案;文本内容最大长度1000，内容过长会返回错误码等信息;系统会校验文本内容，如有问题会返回错误码等信息

voice_idstring必填

音色ID 系统提供多种音色可供选择，具体音色效果、音色ID、音色语种对应关系；音色试听不支持自定义文案音色试听文件命名规范：音色名称#音色ID#音色语种语音合成目前仅支持官方音色哈，不支持自定义音色

voice_languagestring必填

合成音频的文案;文本内容最大长度1000，内容过长会返回错误码等信息;系统会校验文本内容，如有问题会返回错误码等信息

voice_speedinteger

语速有效范围：0.8~2.0，精确至小数点后1位，超出部分将自动四舍五入

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/audio/tts \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "描述看到的画面",
  "voice_id": "genshin_vindi2",
  "voice_language": "zh",
  "voice_speed": "1.0"
}'

Response

返回响应 `200`

HTTP 响应

响应 200object