语音合成接口 (POST /v1/audio/speech)
符合 OpenAI /v1/audio/speech 标准规范的语音合成核心端点。
📥 请求参数
| 参数名 | 类型 | 必填 | 默认值 | 参数说明 |
|---|---|---|---|---|
model | string | 否 | edgetts | 模型或 Provider 标识 (tts-1, edgetts, kokoro) |
input | string | 是 | - | 待朗读合成的文本内容 (最长 8,192 字符) |
voice | string | 否 | alloy | 目标音色 ID 或别名 (alloy, zh-CN-XiaoxiaoNeural) |
response_format | string | 否 | mp3 | 编码格式: mp3, opus, aac, flac, wav, pcm |
speed | float | 否 | 1.0 | 语速控制倍率 (0.25 ~ 4.0) |
stream | boolean | 否 | false | 是否启用 HTTP Chunked 分块流式传输 |
💡 cURL 调用示例
bash
curl http://localhost:8030/v1/audio/speech \
-H "Authorization: Bearer sk-onetts-v1-k9L3mX8QZ2sT4vA7wE1rY6u" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"input": "欢迎使用 OneTTS 语音合成引擎!",
"voice": "alloy",
"response_format": "mp3"
}' \
--output speech.mp3