音色设计
基于声音描述 prompt 生成个性化定制音色,并基于试听文本生成定制音色的试听音频。
POST/v1/audio/voices/design
授权
Authorizationstringheader必填
HTTP: Bearer Auth
- Security Scheme Type: http
- HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 按量计费&资源包>API Key 管理 中查看。
请求头
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
状态详情
