EchoVox
可复现的 EchoVox 文本转语音 API 请求
EchoVox 开发者接口接收 Voice ID、JSON 合成参数和 x-api-key,并返回带生成元数据响应头的音频。
登录后创建和管理 Key,先用一段已知短文本测试,并把响应保存为文件,不要把二进制音频直接输出到终端。
使用生产接口契约
向 https://echovox-api.secondwindltd.xyz/api/v1/v1/text-to-speech/{voice_id} 发送 POST 请求,设置 Content-Type 为 application/json,并通过 x-api-key 传入账户 Key。请求体包含 text、model_id、language 和 stream;当前网页示例使用 echo_turbo_v1。
从可控测试开始
选择 system_maia 这类已知系统音色,使用“Hello from EchoVox.”和 en 语言,把响应保存为 echovox.mp3。先确认一条小请求可以复现,再接入长脚本和生产流程。
记录响应证据
成功音频响应包含 X-EchoVox-Generation-Id、X-EchoVox-Cache 和 X-EchoVox-Seconds-Cost。把生成 ID、Voice ID、原文、语言、模型和输出文件名一起保存。HIT 或 MISS 表示缓存复用,不代表内容已经通过审核。
明确处理失败和凭证
401 通常表示 Key 缺失、无效或已撤销。大任务前先核验 Voice ID,并设置请求超时。不要把真实 Key 放入浏览器源码、截图、公开仓库或支持消息;集成或负责人变化时应撤销旧 Key。
Production checklist
- 在已验证账户中创建 Key
- 使用生产 HTTPS 地址
- 把二进制音频保存到文件
- 记录生成响应头
- 发布前审听发音和内容
- 撤销暴露或停用的 Key