# 查询语音生成任务状态

**方法**: `GET`
**路径**: `/minimax/v1/query/t2a_async_query_v2`

[官方文档](https://platform.minimaxi.com/docs/api-reference/speech-t2a-async-query)

通过异步请求得到的 task\_id, get 请求{{BASE\_URL}}/minimaxi/v1/query/t2a\_async\_query\_v2
并提交task\_id来获得获得任务完成情况

## 请求参数

### Query 参数

```text
task_id
integer
必需
示例:
95157322514444
```

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

## 请求示例代码

### Shell

```bash
curl --location --request GET '/minimax/v1/query/t2a_async_query_v2?task_id=95157322514444' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
task_id
integer
必需
任务 ID，提交任务时返回的信息
status
string
必需
该任务的当前状态。
Processing: 该任务正在处理中
Success: 该任务已完成
Failed: 任务失败
Expired: 任务已过期
可用选项: success, failed, expired, processing
file_id
integer
必需
任务创建成功后返回的对应音频文件的 ID。
当任务完成后，可通过 file_id 调用 文件检索接口 进行下载
当请求出错时，不返回该字段 注意：返回的下载 URL 自生成起 9 小时（32,400 秒）内有效，过期后文件将失效，生成的信息便会丢失，请注意下载信息的时间
base_resp
object
可选
本次请求的状态码及其详情
status_code
integer
必需
状态码
0: 正常
1002: 限流
1004: 鉴权失败
1039: 触发 TPM 限流
1042: 非法字符超10%
2013: 参数错误
status_msg
string
状态详情
必需
```

#### 示例

```json
{
    "task_id": 95157322514444,
    "status": "Processing",
    "file_id": 95157322514496,
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}
```
