v1

latestOpenAPI 3.0.1ZHIPU AI 开发者协议和政策2026-07-2649130210.9 KB
模型 API

音色复刻

使用音色复刻技术,基于示例音频生成指定音色、文本内容的语音合成。点击 Try it 按钮可快速试用。

post/paas/v4/voice/clone

Request body

model'glm-tts-clone' required

模型

voice_namestring required

指定唯一的音色名称

textstring

示例音频的文本内容,选填

inputstring required

生成试听音频的目标文本内容

file_idstring required

示例音频的file_id,通过文件接口上传获取。大小限制不超过10M,建议音频时长在3秒到30秒之间。

request_idstring

请求唯一标识符。由用户端传递,ID长度要求:最少6个字符,最多64个字符,建议使用UUID格式确保唯一性,若未提供平台将自动生成。

Example request

{
  "model": "glm-tts-clone",
  "voice_name": "my_custom_voice_001",
  "text": "你好,这是一段示例音频的文本内容,用于音色复刻参考。",
  "input": "欢迎使用我们的音色复刻服务,这将生成与示例音频相同音色的语音。",
  "file_id": "file_abc123def456ghi789"
}

Response

业务处理成功

voicestring

音色

file_idstring

音频试听文件ID

file_purposestring

文件 purpose,固定为voice-clone-output

request_idstring

请求 ID

Example response

{
  "voice": "voice_clone_20240315_143052_001",
  "file_id": "file_xyz789abc456def123",
  "file_purpose": "voice-clone-output",
  "request_id": "voice_clone_req_20240315_143052_001"
}