常见问题

第一次接入从哪里开始

打开概览与快速开始，获取可用音色后，先完成一次 HTTP 非流式请求。

使用多角色对话 · 多 Context，也可以只注册一个音色。普通 TTS 单连接与普通 TTS 多 Context 不支持这两个模型。

HTTP 流式是一次提交文本、分片接收音频。需要持续追加文本时，使用模型支持的 WebSocket 接口。

V4 / V3 Turbo 使用粤语文本，并设置 language_code=yue。普通话使用 zh。参数不会把普通话文本自动翻译为粤语，完整清单见支持语言。

请等待对应任务完成。普通单连接等待 final；普通多 Context 先 flush、再 close_context、等待 final；对话接口的 close_context 会处理剩余文本，再发出 final。各协议不能套用同一关闭顺序。

先选接口类型，再选开发语言。不同 WSS SDK 的消息结构不同，见SDK 与示例。

效果会受音色、文本与上下文影响。一次只调整一个字段，使用同一段文本试听。对话 WSS 的稳定性控制与 HTTP 的相似度控制不是同一套字段，详见模型介绍。

先从音色列表选择账号可用音色，再用目标模型合成短句确认。不要仅根据克隆服务等级推断模型兼容性。

先检查 api-key、voice_id、模型与接口组合、音频格式及并发线路。根据错误响应中的 code、field 和 message 定位问题，不要把失败响应当作音频。查询调用信息可使用请求查询。

查询主 Key 用量用于查看账号用量；按音色或请求查询，见用量与请求查询。