异步语音合成

POST

/minimax/v1/t2a_async_v2

提交文本转语音异步任务。text 与 text_file_id 二选一；提交后通过 GET /minimax/v1/query/t2a_async_query_v2 轮询。

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

异步语音合成直接提供文本内容使用所有可选参数的文本输入使用 TXT 文件 ID 作为输入使用 ZIP 压缩包批量处理处理长文本（接近 5 万字符限制）

{
    "model": "speech-02-turbo",
    "text": "你好，欢迎使用 MiniMax 语音合成服务。",
    "voice_setting": {
        "voice_id": "male-qn-qingse",
        "speed": 1,
        "vol": 1,
        "pitch": 0
    },
    "audio_setting": {
        "sample_rate": 32000,
        "format": "mp3"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

异步语音合成直接提供文本内容使用所有可选参数的文本输入使用 TXT 文件 ID 作为输入使用 ZIP 压缩包批量处理处理长文本（接近 5 万字符限制）

curl --location '/minimax/v1/t2a_async_v2' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "speech-02-turbo",
    "text": "你好，欢迎使用 MiniMax 语音合成服务。",
    "voice_setting": {
        "voice_id": "male-qn-qingse",
        "speed": 1,
        "vol": 1,
        "pitch": 0
    },
    "audio_setting": {
        "sample_rate": 32000,
        "format": "mp3"
    }
}'

返回响应

🟢200成功

application/json

任务提交成功

Bodyapplication/json

示例

{
    "task_id": 0,
    "task_token": "string",
    "file_id": 0,
    "usage_characters": 0,
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}

🟠400请求有误

🟠401没有权限

🟠429

修改于 2026-10-24 18:33:12

查询视频生成任务

查询异步语音合成任务