1. HTTP 合成
MyVocal AI语音大模型API文档
  • 文字转语音大模型
    • 概览与快速开始
      • 模型介绍
      • 选择模型与接口
      • 支持语言
      • 音频格式与播放
      • 常见问题
      • SDK 与示例
    • 接口参考
      • HTTP 合成
        • HTTP 流式合成
          POST
        • HTTP 非流式合成
          POST
      • 音色管理
        • 创建声音
        • 获取声音列表
        • 删除声音
      • WebSocket 合成
        • 普通 TTS · 单连接
        • 普通 TTS · 多 Context
        • 多角色对话 · 多 Context
      • 用量与请求查询
        • 查询主key用量
        • Request_id客户端查询
        • 发音人用量查询
      • 子密钥管理
        • 创建子 Key
        • 查询子 Key 列表
        • 获取单个子 Key 详情
        • 更新子 Key
        • 查询子 Key 用量
  • 金融行业定制TTS模型
    • 文字转语音 Skyblight
      • 创建声音
      • 获取声音列表
      • 流式文字转语音
      • 非流式文字转语音
      • 删除声音
      • 用量查询
    • 全双工通信
      • websocket接入说明
      • V2 双向流式合成(WebSocket)
  • 语音转文字ASR
    • 概览与接入
      • 快速开始:文件转录
      • 快速开始:实时转录
      • 模型与能力
      • 更新记录
    • 接口参考
      • 实时转录
      • 创建文件转录
      • 查询用量
  • 企业客户声音定制服务
    • 定制属于你的专属声音
  1. HTTP 合成

HTTP 非流式合成

POST
https://api.voicelibrary.co/enterprise/v1/tts/{voice_id}/
一次提交文本,返回完整音频,适合下载、保存和内容生成。

支持模型#

myvocal_v4、myvocal_v3_turbo、myvocal_v3、multilingual_v2;省略 model_id 使用默认 Turbo。查看模型介绍。

请求示例#

将 YOUR_API_KEY 和 YOUR_VOICE_ID 替换为企业 Key 与已有音色 ID。两个模型使用相同接口,可将示例中的 myvocal_v4 替换为 myvocal_v3_turbo。
成功时返回音频字节;应在收到完整响应后保存或播放。先检查 HTTP 状态与 Content-Type;失败返回的 JSON 错误不能当作 MP3 播放。

重要参数#

参数使用说明
text要合成的文本
model_id选择模型;省略时使用默认模型
voice_settings声音设置,按模型适用范围配置
language_code可选语言代码,放在 JSON 请求体
priority选择并发线路

稳定性与相似度#

stability 与 similarity_boost 放在 voice_settings 中,取值范围为 0..1。先使用 0.5 与 0.75,再通过试听逐项调整。myvocal_v3 的 stability 仅使用 0、0.5、1。

其他生成控制#

V4 / V3 Turbo 不使用 style、speed 和 use_speaker_boost。这些字段的其他模型适用范围见下方参数定义。seed 用于尽量提高相同输入的生成一致性,不保证音频逐字节相同。

并发线路#

auto:优先独享并发,资源占满时可切换共享线路。
dedicated_concurrency:使用独享并发线路。
shared_concurrency:使用共享线路,可能发生排队。

输出语言#

V4 与 V3 Turbo 支持 94 种语言;普通话 zh、粤语 yue。省略 language_code 时根据文本选择语言,显式传入时使用目标语言文本。完整清单。

音频与完成#

先检查 HTTP 状态与内容类型,再处理音频;错误 JSON 不能作为 MP3 播放。响应体结束表示本次 HTTP 返回完成。PCM 的 direct 与音频格式选择见音频格式与播放。

Endpoint#

默认域名为 https://api.voicelibrary.co,需要指定区域时见请求服务器。

常见问题#

没有音频、模型不支持或格式错误时,先核对响应状态、model_id、voice_id 和 format。更多说明见常见问题。

请求参数

Path 参数

Query 参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.voicelibrary.co/enterprise/v1/tts//?format=mp3_44100_64&quality=0' \
--header 'api-key;' \
--header 'Content-Type: application/json' \
--data '{
  "text": "hi, this is a TTS Test",
  "model_id": "multilingual_v2",
  "language_code": "en",
  "voice_settings": {
    "stability": 0.7,
    "similarity_boost": 0.7,
    "speed": 1
  },
  "priority": "auto"
}'
响应示例响应示例
{}
上一页
HTTP 流式合成
下一页
音色管理
Built with