跳到正文
土土金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日 01:33。

没找到答案?加客服微信 JsnonoChat,发送报错信息里的 request id,我们帮你排查。