文字转语音 API 接入指南:用 API 密钥把配音接进你的产品

工作台适合人操作;产品里要批量生成,就走 API。这篇按接入顺序写。

1. 创建 API 密钥

登录后进入 API 密钥 页,创建一把密钥。密钥只显示一次,妥善保存;泄露后可在同一页吊销重建。

2. 生成配音

向生成接口提交文本、音色 ID 与模型,返回音频地址与字符级时间轴(每个字的起止秒数),字幕无需二次处理。请求体与工作台一致:text、voiceId、modelId,可选 stability、similarity、style、speed、seed。

长文本走长文接口:最多 50,000 字,自动分段、上下文连贯、返回单个文件与整篇时间轴。

3. 选音色与模型

• 音色 ID 来自你的音色库——社区音色、克隆音色、设计音色都可用
• 模型:旗舰(表现力、情绪标签)/ 多语言标准 / 极速(半价、低延迟),见模型选择
• 品牌名、术语读法用发音词典,一次定义处处生效

4. 计费与失败处理

每次调用按操作扣积分,价格与工作台按钮一致;上游失败自动全额返还,你的代码不需要处理退款逻辑。余额不足返回明确错误码,按需购买套餐。

5. 常见错误

| 现象 | 原因 | 处理 | | --- | --- | --- | | 401 | 密钥无效或已吊销 | 重新创建密钥 | | 积分不足 | 余额为 0 | 充值或降级模型 | | 文本过长 | 超出模型单次上限 | 改用长文接口 | | 口音不对 | 音色与语言不匹配 | 为每种语言选母语音色,见多语言口音 |

创建我的 API 密钥 →