POST/minimax/v1/t2a_v2

同步语音合成 V2

https://platform.minimaxi.com/docs/api-reference/speech-t2a-http

API Key application/json

MiniMax TTS V2

调用与返回说明

同步文本转语音入口。当前官方模型包括 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；语音、音频和字幕配置都属于 JSON Body 的嵌套字段。

请求时注意

请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
文本少于 10,000 字符时可使用同步接口；长文本或需要文件任务时改用异步 TTS。
流式请求返回 SSE/分段音频时，客户端必须按事件和 data.status 处理，网络 chunk 不是完整事件。

返回时注意

HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
非流式 `output_format=url` 的地址有效期为 24 小时；hex 音频需要按所选格式自行解码。

Request

请求

/minimax/v1/t2a_v2

Body

必填

Bodyobject

modelstring必填

语音模型。可用官方系列：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。

示例speech-2.8-hd

textstring必填

待合成文本，少于 10,000 字符。

示例欢迎使用青云TOP API。

streamboolean

是否流式返回，默认 false。

示例false

voice_settingobject

voice_idstring必填

音色 ID。

示例male-qn-qingse

speednumber

语速，范围 0.5–2，默认 1。

示例1

volnumber

音量，范围大于 0 且不超过 10，默认 1。

示例1

pitchinteger

语调，范围 -12–12，默认 0。

示例0

emotionstring

部分 speech-2.x/02/01 型号支持的情绪枚举。

示例calm

audio_settingobject

sample_rateinteger

采样率，例如 32000。

示例32000

bitrateinteger

比特率，例如 128000。

示例128000

formatstring

mp3、pcm 或 flac。

示例mp3

channelinteger

声道数，1 或 2。

示例1

pronunciation_dictobject

tonearray<object>

元素array<string>

发音替换条目，例如处理/(chu3)(li3)。

示例["处理/(chu3)(li3)"]

language_booststring

语言/方言增强，可设 auto 或官方枚举。

示例auto

subtitle_enableboolean

是否生成字幕，默认 false。

示例false

subtitle_typestring

字幕粒度：sentence、word 或 word_streaming。

示例sentence

output_formatstring

非流式输出：url 或 hex，默认 hex。

示例hex

aigc_watermarkboolean

是否添加音频节奏标识，默认 false。

示例false

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	是	请求体的媒介类型，必须设置为 application/json 以确保请求数据的格式为 JSON	-

请求示例application/json

curl -X POST https://top.qingyuntop.ai/minimax/v1/t2a_v2 \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

返回响应 `200`

成功响应

响应 200object

dataobject

audiostring|null

同步合成音频。非流式通常为 hex；只有请求 `output_format=url` 时才是临时 URL。

statusinteger

流式音频状态；1 表示合成中，2 表示结束。

trace_idstring

请求追踪 ID，排查错误时保存。

extra_infoobject

audio_lengthinteger

音频时长，单位毫秒。

audio_formatstring

生成音频格式，例如 mp3、pcm 或 flac。

usage_charactersinteger

计费字符数，用于对账。

base_respobject

status_codeinteger

业务状态码；0 表示成功，其他值需要结合 status_msg 处理。

status_msgstring

业务状态描述。

响应示例application/json

{
  "data": {
    "audio": "HEX_AUDIO_DATA",
    "status": 2
  },
  "trace_id": "TRACE_ID",
  "extra_info": {
    "audio_length": 1200,
    "audio_format": "mp3",
    "usage_characters": 11
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

MiniMax TTS V2

调用与返回说明

请求时注意

请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
文本少于 10,000 字符时可使用同步接口；长文本或需要文件任务时改用异步 TTS。
流式请求返回 SSE/分段音频时，客户端必须按事件和 data.status 处理，网络 chunk 不是完整事件。

返回时注意

HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
非流式 `output_format=url` 的地址有效期为 24 小时；hex 音频需要按所选格式自行解码。

同步语音合成 V2

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

返回响应 `200`