非流式文字转语音
POST
https://openapi.myvocal.ai/v2/ai/speech/tts
POST https://openapi.myvocal.ai/v2/ai/speech/tts快速开始
1.
2.
YOUR_API_KEY 和 <VOICE_ID> 替换为自己的值。3.
成功响应
format 对应的文件。format 决定输出音频格式。参数使用提示
voice、text、model 为必填项。language 建议明确传入；不传时服务会根据文本自动判断。format 必须与所选模型支持的格式匹配。sample_rate 单位为 Hz；电话场景使用 ulaw 时通常选择 8000。seed 使用小写；相同文本和配置下，相同 seed 可提高多次生成结果的一致性。priority 通常使用 auto。常见错误
| HTTP 状态 | 常见原因 | 处理建议 |
|---|---|---|
400 | 字段类型、模型、语言或音频格式不符合要求 | 检查请求参数和模型能力表 |
401 / 403 | API Key 无效或当前账号无权限 | 检查 API-Key Header 和账号权限 |
429 | 请求频率或并发达到限制 | 降低请求频率，稍后重试 |
5xx | 服务暂时不可用 | 保留请求时间并稍后重试 |
相关文档
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.myvocal.ai/v2/ai/speech/tts' \
--header 'API-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"voice": "<VOICE_ID>",
"text": "您好，这是一次语音文件生成测试。",
"model": "Skyblight-Turbo",
"language": "zh",
"format": "wav",
"sample_rate": 24000,
"priority": "auto"
}'