---
title: "Query T2A Async V2 Task Status"
method: POST
path: "/v1/query/t2a_async_query_v2"
tags: ["Text to Audio"]
---

# Query T2A Async V2 Task Status

`POST /v1/query/t2a_async_query_v2`

## Request

- Base URL: `https://api.minimax.io`
- URL: `https://api.minimax.io/v1/query/t2a_async_query_v2`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/minimax/apis/minimax-api-2/docs/v1/query/t2a_async_query_v2/post.ts> (a function with typed inputs; its response is checked against the schema)

Query the status of an asynchronous text-to-audio task

## Request body

- T2AAsyncV2QueryReq
  - `task_id` integer, required: Task ID to query
  - `group_id` string, required: Group ID

## Response `200`

Successful response

- T2AAsyncV2QueryResp
  - `status` 'success' | 'failed' | 'expired' | 'processing': Task status
  - `task_id` integer: Task ID
  - `file_id` integer: File ID for downloading the result

## Other responses

- `400`: Bad request
- `401`: Authentication failed
- `500`: Internal server error

---

[API](https://skmtc.dev/minimax/apis/minimax-api-2.md) - [All operations](https://skmtc.dev/minimax/apis/minimax-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/minimax/apis/minimax-api-2/revisions/b18c2ab45c0e?raw)