Skip to content

语音合成接口 (POST /v1/audio/speech) ​

符合 OpenAI /v1/audio/speech 标准规范的语音合成核心端点。


📥 请求参数 ​

参数名类型必填默认值参数说明
modelstring否edgetts模型或 Provider 标识 (tts-1, edgetts, kokoro)
inputstring是-待朗读合成的文本内容 (最长 8,192 字符)
voicestring否alloy目标音色 ID 或别名 (alloy, zh-CN-XiaoxiaoNeural)
response_formatstring否mp3编码格式: mp3, opus, aac, flac, wav, pcm
speedfloat否1.0语速控制倍率 (0.25 ~ 4.0)
streamboolean否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

Released under the Apache-2.0 License.