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.