Create Asynchronous Text-to-Speech Task V2

POST

/minimax/v1/t2a_async_v2

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

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Task created successfully, returning task ID and related information

Body

🟠400

🟠401

🟠429

Request Example

Shell

JavaScript

Java

Swift

cURL

Directly provide text contentText input using all optional parametersUse TXT file ID as inputBatch Processing Using ZIP ArchivesProcessing long text (approaching 50,000 character limit)

curl --location --request POST '/minimax/v1/t2a_async_v2' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "speech-02-hd",
    "text": "The real danger is not that computers start thinking like humans, but that humans start thinking like computers.",
    "voice_setting": {
        "voice_id": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85",
        "speed": 1,
        "vol": 1,
        "pitch": 0
    }
}'

Response Example

200 - Standard response for successful task creation

{
    "task_id": "95157322514444",
    "task_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "file_id": 95157322514444,
    "usage_characters": 101,
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}

Modified at 2026-03-06 15:34:51

Create task bytedance/seedream-4

Synchronous Text-to-Speech V2