API 参考
语音合成 TTS(Audio Speech)
POST /v1/audio/speech 的参数、请求示例和返回格式:把文本合成为语音文件,用于订单播报、语音通知和有声内容。格式与 OpenAI 语音合成接口一致,本站按原格式转发请求。
POST /v1/audio/speech 把一段文本合成为语音,直接返回音频文件(默认 MP3),适合订单播报、语音通知、有声内容和客服语音回复。格式与 OpenAI 语音合成接口一致。本站把请求按原格式转发给模型服务,可用的音色和格式因模型而异,以对应模型的官方说明为准。
POST
https://open.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://open.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://open.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://open.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 | OpenAI | 标准 | ¥30 | ¥30 | — |
| tts-1-1106 | OpenAI | 标准 | ¥30 | ¥30 | — |
| tts-1-hd-1106 | OpenAI | 标准 | ¥60 | ¥60 | — |
| tts-1-hd | OpenAI | 标准 | ¥60 | ¥60 | — |
| speech-2.8-turbo | MiniMax | 标准 | ¥700 | ¥700 | — |
| speech-2.8-hd | MiniMax | 标准 | ¥700 | ¥700 | — |
价格为人民币,取各模型最低价分组;价格更新于 2026年11月12日 20:17。
没找到答案?加客服微信 JsnonoChat,发送报错信息里的 request id,我们帮你排查。