青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/minimax/v1/t2a_async_v2

创建异步语音合成任务 V2

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

API Key application/json
MiniMax 长文本异步 TTS

调用与返回说明

异步长文本语音合成。文本与 text_file_id 二选一，创建后查询任务状态，再用 file_id 检索音频。模型范围为 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。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
  • 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
  • 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
  • text 少于 50,000 字符；更长内容使用已上传的 txt/zip 文件并传 text_file_id。两者不能同时提交。
  • 创建成功后保存 task_id；任务完成时再用 file_id 调用文件检索，下载 URL 自生成起约 9 小时有效。

返回时注意

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

请求

/minimax/v1/t2a_async_v2

Body

必填
Bodyapplication/json
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

短文本输入，少于 50,000 字符；与 text_file_id 二选一。

示例长文本语音合成示例。
text_file_idinteger

上传的 txt/zip 文件 ID；与 text 二选一。

示例123456789
voice_settingobject
voice_idstring必填

音色 ID。

示例audiobook_male_1
speednumber

语速，0.5–2。

示例1
volnumber

音量，大于 0 且不超过 10。

示例1
pitchinteger

语调，-12–12。

示例1
audio_settingobject
audio_sample_rateinteger

采样率。

示例32000
bitrateinteger

比特率。

示例128000
formatstring

输出格式。

示例mp3
channelinteger

声道数。

示例2
language_booststring

语言/方言增强。

示例auto
aigc_watermarkboolean

是否添加音频节奏标识。

示例false

路径、查询与 Header 参数

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

返回响应 200

成功响应
响应 200application/json
响应 200object
task_idstring

异步任务 ID。

file_idinteger

任务完成后的音频文件 ID。

base_respobject
status_codeinteger

0 表示请求正常。

status_msgstring

状态描述。

MiniMax 长文本异步 TTS

调用与返回说明

异步长文本语音合成。文本与 text_file_id 二选一，创建后查询任务状态，再用 file_id 检索音频。模型范围为 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。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
  • 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
  • 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
  • text 少于 50,000 字符；更长内容使用已上传的 txt/zip 文件并传 text_file_id。两者不能同时提交。
  • 创建成功后保存 task_id；任务完成时再用 file_id 调用文件检索，下载 URL 自生成起约 9 小时有效。

返回时注意

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