---
title: "Text to Audio Async V2"
method: POST
path: "/v1/t2a_async_v2"
tags: ["Text to Audio"]
---

# Text to Audio Async V2

`POST /v1/t2a_async_v2`

## Request

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

Convert text to audio asynchronously using MiniMax T2A Async V2 API with support for long text processing

## Request body

- T2AAsyncV2Req
  - `model` 'speech-2.5-hd-preview' | 'speech-2.5-turbo-preview' | 'speech-02-hd' | 'speech-02-turbo' | 'speech-01-hd' | 'speech-01-turbo', required: Model ID for text-to-audio conversion
  - `text` string: Text content to convert to audio
  - `text_file_id` integer: Text file ID for file-based input
  - `voice_setting` T2AAsyncV2VoiceSetting, required
    - `voice_id` string, required: Voice ID
    - `speed` number, double: Speech speed (default: 1.0)
    - `vol` number, double: Volume level (default: 1.0)
    - `pitch` integer: Pitch level (default: 0)
    - `emotion` string: Emotion setting
    - `english_normalization` boolean: Whether to normalize English text (legacy field)
    - `add_silence` number, double: Add silence between sentences
    - `text_normalization` boolean: Whether to normalize text
  - `audio_setting` T2AAsyncV2AudioSetting
    - `audio_sample_rate` integer: Audio sample rate
    - `bitrate` integer: Bitrate
    - `format` string: Generated audio file format
    - `channel` 'Mono' | 'Binaural': Audio channel configuration
    - `force_cbr` boolean: Force CBR encoding
  - `pronunciation_dict` T2AAsyncV2PronunciationDict
    - `tone` string[]: Tone specification list for specific phrases
  - `language_boost` string: Language boost setting
  - `callback_url` string: Callback URL for task completion notification
  - `voice_modify` VoiceModify
    - `modify_type` string: Voice modification type
    - `modify_value` number, double: Modification value
  - `aigc_watermark` boolean: Whether to add AIGC watermark

## Response `200`

Successful response

- T2AAsyncV2Resp
  - `task_id` integer: Task ID for tracking the async operation
  - `task_token` string: Task token for authentication
  - `file_id` integer: Expected file ID for downloading the result
  - `usage_characters` integer: Estimated character consumption

## 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)