跳转到主要内容
Open API 在音色列表、翻译结果与克隆请求中使用简短的 provider 代号 — 系统预设为 S1S7,克隆为 V1V5

代号一览

系统预设档位为 S1S7,其中 S7 含粤语预设音色。 需要改句或再次提交时,请 成对复制 API 返回的 voiceIdprovider(音视频翻译尤其如此)。见 音色

在哪些接口需要传 provider

克隆引擎(V1V5

创建克隆音色,或音视频翻译启用声音克隆时,传入 V1V5。与 vmeg.ai 网页端克隆选项一致。

选型建议

文本转语音:voiceId 与组批规则

文本转语音 每次请求最多可在 data[] 中提交 50 条。 请使用 音色 接口返回的 voiceId TTS 请求中 不要传 provider 组批规则: voiceId 必须有效。 若不在您的系统或克隆库中,API 返回 400,并提示通过 POST /openapi/v1/assets/voice/basic/listPOST /openapi/v1/assets/voice/clone/list 获取。 同一请求内音色须兼容 — 系统预设须同一档位(同为 S* 系列),克隆须同一引擎(同为 V1V5 之一)。例如不能在同一请求中混用 S1S2,或 V1V2 timbreRefAudio 仅适用于克隆引擎。 若批次中含 timbreRefAudio,该批须全部为克隆引擎(V1V5),不能与系统预设 voiceId 混用。 示例错误文案见 错误码 →「TTS 音色校验」。
语言 locale 见 支持的语言provider 表示 引擎类型,不是语言代码。