跳到正文
土土金API

API 參考

語音合成 TTS(Audio Speech)

POST /v1/audio/speech 的參數、請求示例和返回格式:把文本合成為語音檔案,用於訂單播報、語音通知和有聲內容。格式與 OpenAI 語音合成介面一致,本站按原格式轉發請求。

POST /v1/audio/speech 把一段文本合成為語音,直接返回音訊檔案(預設 MP3),適合訂單播報、語音通知、有聲內容和客服語音回覆。格式與 OpenAI 語音合成介面一致。本站把請求按原格式轉發給模型服務,可用的音色和格式因模型而異,以對應模型的官方說明為準。

POSThttps://www.tutujin.com/v1/audio/speech

請求頭

請求頭必填說明
Authorization是Bearer sk-...,控制台建立的 API Key
Content-Type是application/json

請求參數

參數類型必填說明
modelstring是模型名,例如 tts-1
inputstring是要朗讀的文本。單次長度有上限,長文先按句子或段落拆開
voicestring是音色。OpenAI 的 TTS 模型可選 alloy、echo、fable、onyx、nova、shimmer 等;其他廠商模型的音色名稱不同
response_formatstring否音訊格式,OpenAI 模型支援 mp3(預設)、opus、aac、flac、wav、pcm
speednumber否語速,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.mp3

返回格式

成功時直接返回音訊二進位制資料,不是 JSON。響應頭 Content-Type 對應音訊類型,例如 MP3 是 audio/mpeg。用 cURL 時加 --output 儲存成檔案。

出錯時返回 JSON 錯誤體和 HTTP 錯誤狀態碼,所以寫程式碼時先判斷狀態碼,再按音訊處理響應內容,見錯誤碼與重試。

注意事項

  • 這個介面是原樣轉發,沒有在本站單獨實測。換用其他廠商的語音模型時,先確認它支援的 voice 取值和返回格式。
  • 長文本先拆成句子或段落分別合成,再按順序拼接音訊;單次文本過長會報錯。
  • 固定話術(如「您的訂單已發貨」)合成一次後快取音訊檔案重複使用,不必每次重新請求。
  • 計費按模型價目表執行,具體扣費以控制台「操作日誌」為準。

支援此介面的模型

模型廠商最低價分組輸入 ¥/百萬輸出 ¥/百萬按次 ¥/次
minimax/speech-2.8-turboMiniMax標準——¥4
minimax/speech-2.8-hdMiniMax標準——¥7
tts-1-1106OpenAI標準¥30¥30—
tts-1OpenAI標準¥30¥30—
tts-1-hd-1106OpenAI標準¥60¥60—
tts-1-hdOpenAI標準¥60¥60—
speech-2.8-hdMiniMax標準¥700¥700—
speech-2.8-turboMiniMax標準¥700¥700—

價格為人民幣,取各模型最低價分組;價格更新於 2026年11月13日 下午6:08。

沒找到答案?加客服微信 JsnonoChat,傳送報錯資訊裡的 request id,我們幫你排查。