音色设计

基于声音描述 prompt 生成个性化定制音色,并基于试听文本生成定制音色的试听音频。

POST/v1/audio/voices/design

授权

Authorizationstringheader必填
HTTP: Bearer Auth

请求头

Content-Typeenum<string>默认值: application/json必填

请求体application/json

promptstring必填

音色描述。

preview_textstring必填

试听文本,15-100 个汉字字符或单词。

voice_idstring

自定义音色 ID。未传入时,服务端自动生成唯一 ID,格式为:
ttv-voice-{yyyyMMddHHmmss}-{8位随机字符}
自定义 ID 需满足以下规范:
  • 长度 8-64 个字符,首字符须为英文字母;
  • 仅允许字母、数字、连字符(-)和下划线(_),末位不能为连字符或下划线;
  • 不可与已有克隆/设计音色重复。

响应体结构

voice_idstring

生成的音色 ID,可用于语音合成。

trial_audiostring

试听音频地址。

base_respobject

本次请求的状态码及其详情

base_resp.status_codeinteger

状态码(0=正常;100001=参数错误;100003=voice_id 重复;100004=敏感内容;100101=鉴权失败;100501=触发 RPM 限流;100999=系统内部错误)

base_resp.status_msgstring

状态详情