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