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

查询语音生成任务状态

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

API Key none
MiniMax 异步 TTS 查询

调用与返回说明

查询长文本语音任务状态；成功后读取 file_id 并跳转文件检索。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
  • 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
  • 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
  • task_id 放在 Query 参数；建议采用退避轮询并设置业务超时。

返回时注意

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

请求

/minimax/v1/query/t2a_async_query_v2

Body

必填

GET 请求无需 JSON 请求体，只需发送页面列出的请求头和路径、查询参数。

路径、查询与 Header 参数

参数位置类型必填说明示例
task_idQuerystring是异步 TTS 任务 ID。TASK_ID
Response

返回响应 200

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

任务 ID。

statusstring

processing、success、failed 或 expired。

file_idinteger

success 时的文件 ID。

base_respobject
status_codeinteger

业务状态码。

status_msgstring

状态描述。

MiniMax 异步 TTS 查询

调用与返回说明

查询长文本语音任务状态；成功后读取 file_id 并跳转文件检索。

请求时注意

  • 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
  • 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
  • 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
  • task_id 放在 Query 参数；建议采用退避轮询并设置业务超时。

返回时注意

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