跳转到主要内容
MiniMax 语音合成模型通过 Upmore 以标准音频接口（/v1/audio/speech）提供服务。发送文本、直接返回音频字节，按输入字符数计费。

​
可用模型

模型说明
speech-2.8-hd最新一代，高保真
speech-2.8-turbo最新一代，低时延
speech-2.6-hd / speech-2.6-turbo上一代
speech-02-hd / speech-02-turbo历史版本
speech-01-hd / speech-01-turbo历史版本
hd 系列音质优先；turbo 系列时延优先、价格更低。所有模型请求格式完全一致。

​
快速示例

curl https://api.upmore.net/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "speech-2.8-hd",
    "input": "你好，欢迎使用语音合成服务。",
    "voice": "male-qn-qingse",
    "response_format": "mp3"
  }' --output speech.mp3

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.upmore.net/v1"
)

response = client.audio.speech.create(
    model="speech-2.8-hd",
    voice="male-qn-qingse",
    input="你好，欢迎使用语音合成服务。",
    response_format="mp3",
)

response.write_to_file("speech.mp3")

import fs from 'node:fs'
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.UPMORE_API_KEY,
  baseURL: 'https://api.upmore.net/v1',
})

const speech = await client.audio.speech.create({
  model: 'speech-2.8-hd',
  voice: 'male-qn-qingse',
  input: '你好，欢迎使用语音合成服务。',
  response_format: 'mp3',
})

fs.writeFileSync('speech.mp3', Buffer.from(await speech.arrayBuffer()))

​
参数说明

参数类型必填说明
modelstring是上表中的任一模型 ID
inputstring是要合成的文本，按字符数计费
voicestring是MiniMax 音色 ID（如 male-qn-qingse、female-shaonv），不是 OpenAI 的音色名
response_formatstring否mp3（默认）、wav、flac、aac、pcm
speednumber否语速，0.5 – 2，默认 1
metadataobject否透传给上游的厂商专属字段

​
进阶：厂商参数透传

MiniMax 原生 T2A 接口支持的参数都可以通过 metadata 透传——整个对象会合并进上游请求体： 
"metadata": {
  "voice_setting": { "emotion": "happy", "pitch": 0 },
  "audio_setting": { "sample_rate": 32000, "bitrate": 128000 },
  "language_boost": "Chinese"
}
平台默认直接返回音频字节。设置 "metadata": {"output_format": "url"} 可改为 302 跳转到临时音频 URL（curl 需加 -L）。

API 参考

查看可交互的 API Playground。