HTTP 流式合成
POST
https://api.voicelibrary.co/enterprise/v1/tts/{voice_id}/stream
支持模型
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。重要参数
| 参数 | 使用说明 |
|---|---|
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。其他生成控制
style、speed 和 use_speaker_boost。这些字段的其他模型适用范围见下方参数定义。seed 用于尽量提高相同输入的生成一致性，不保证音频逐字节相同。并发线路
auto：优先独享并发，资源占满时可切换共享线路。dedicated_concurrency：使用独享并发线路。shared_concurrency：使用共享线路，可能发生排队。输出语言
zh、粤语 yue。省略 language_code 时根据文本选择语言，显式传入时使用目标语言文本。完整清单。音频与完成
direct 与音频格式选择见音频格式与播放。Endpoint
https://api.voicelibrary.co，需要指定区域时见请求服务器。常见问题
model_id、voice_id 和 format。更多说明见常见问题。请求参数
Path 参数
Query 参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.voicelibrary.co/enterprise/v1/tts//stream?format=mp3_44100_64&quality=0&direct=1&compress=false' \
--header 'api-key;' \
--header 'Content-Type: application/json' \
--data '{
"text": "string",
"voice_settings": {
"stability": 0.7,
"similarity_boost": 0.7,
"speed": 0.7,
"style": 0.3,
"use_speaker_boost": true
},
"model_id": "multilingual_v2",
"language_code": "en",
"priority": "auto",
"text_normalization": "on",
"seed": 12345
}'响应示例响应示例
{}