語音合成介面 (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