API 參考
語音合成 TTS(Audio Speech)
POST /v1/audio/speech 的參數、請求示例和返回格式:把文本合成為語音檔案,用於訂單播報、語音通知和有聲內容。格式與 OpenAI 語音合成介面一致,本站按原格式轉發請求。
POST /v1/audio/speech 把一段文本合成為語音,直接返回音訊檔案(預設 MP3),適合訂單播報、語音通知、有聲內容和客服語音回覆。格式與 OpenAI 語音合成介面一致。本站把請求按原格式轉發給模型服務,可用的音色和格式因模型而異,以對應模型的官方說明為準。
POST
https://www.tutujin.com/v1/audio/speech請求頭
| 請求頭 | 必填 | 說明 |
|---|---|---|
Authorization | 是 | Bearer sk-...,控制台建立的 API Key |
Content-Type | 是 | application/json |
請求參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | 模型名,例如 tts-1 |
input | string | 是 | 要朗讀的文本。單次長度有上限,長文先按句子或段落拆開 |
voice | string | 是 | 音色。OpenAI 的 TTS 模型可選 alloy、echo、fable、onyx、nova、shimmer 等;其他廠商模型的音色名稱不同 |
response_format | string | 否 | 音訊格式,OpenAI 模型支援 mp3(預設)、opus、aac、flac、wav、pcm |
speed | number | 否 | 語速,0.25 到 4.0,預設 1.0 |
請求示例
curl https://www.tutujin.com/v1/audio/speech \
-H "Authorization: Bearer $TUTUJIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"input": "您的订单已发货,预计明天送达。",
"voice": "alloy"
}' \
--output notice.mp3import os
from openai import OpenAI
client = OpenAI(base_url="https://www.tutujin.com/v1", api_key=os.environ["TUTUJIN_API_KEY"])
with client.audio.speech.with_streaming_response.create(
model="tts-1",
voice="alloy",
input="您的订单已发货,预计明天送达。",
) as resp:
resp.stream_to_file("notice.mp3")import fs from 'node:fs'
import OpenAI from 'openai'
const client = new OpenAI({ baseURL: 'https://www.tutujin.com/v1', apiKey: process.env.TUTUJIN_API_KEY })
const resp = await client.audio.speech.create({
model: 'tts-1',
voice: 'alloy',
input: '您的订单已发货,预计明天送达。',
})
fs.writeFileSync('notice.mp3', Buffer.from(await resp.arrayBuffer()))返回格式
成功時直接返回音訊二進位制資料,不是 JSON。響應頭 Content-Type 對應音訊類型,例如 MP3 是 audio/mpeg。用 cURL 時加 --output 儲存成檔案。
出錯時返回 JSON 錯誤體和 HTTP 錯誤狀態碼,所以寫程式碼時先判斷狀態碼,再按音訊處理響應內容,見錯誤碼與重試。
注意事項
- 這個介面是原樣轉發,沒有在本站單獨實測。換用其他廠商的語音模型時,先確認它支援的
voice取值和返回格式。 - 長文本先拆成句子或段落分別合成,再按順序拼接音訊;單次文本過長會報錯。
- 固定話術(如「您的訂單已發貨」)合成一次後快取音訊檔案重複使用,不必每次重新請求。
- 計費按模型價目表執行,具體扣費以控制台「操作日誌」為準。
支援此介面的模型
| 模型 | 廠商 | 最低價分組 | 輸入 ¥/百萬 | 輸出 ¥/百萬 | 按次 ¥/次 |
|---|---|---|---|---|---|
| minimax/speech-2.8-turbo | MiniMax | 標準 | — | — | ¥4 |
| minimax/speech-2.8-hd | MiniMax | 標準 | — | — | ¥7 |
| tts-1-1106 | OpenAI | 標準 | ¥30 | ¥30 | — |
| tts-1 | OpenAI | 標準 | ¥30 | ¥30 | — |
| tts-1-hd-1106 | OpenAI | 標準 | ¥60 | ¥60 | — |
| tts-1-hd | OpenAI | 標準 | ¥60 | ¥60 | — |
| speech-2.8-hd | MiniMax | 標準 | ¥700 | ¥700 | — |
| speech-2.8-turbo | MiniMax | 標準 | ¥700 | ¥700 | — |
價格為人民幣,取各模型最低價分組;價格更新於 2026年11月13日 下午6:08。
沒找到答案?加客服微信 JsnonoChat,傳送報錯資訊裡的 request id,我們幫你排查。