创建异步语音合成任务 V2

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "id": 495899864,
  "name": "创建异步语音合成任务 V2",
  "type": "http",
  "serverId": "",
  "preProcessors": [],
  "postProcessors": [],
  "inheritPreProcessors": {},
  "inheritPostProcessors": {},
  "description": "https://platform.minimaxi.com/docs/api-reference/speech-t2a-async-create",
  "operationId": "createAsyncTextToAudioTask",
  "sourceUrl": "",
  "method": "post",
  "path": "/minimax/v1/t2a_async_v2",
  "tags": [
    "异步语音合成"
  ],
  "status": 1,
  "requestBody": {
    "type": "application/json",
    "parameters": [],
    "jsonSchema": {
      "type": "object",
      "properties": {},
      "x-apifox-orders": []
    },
    "examples": [
      {
        "name": "直接提供文本内容",
        "value": "{\n    \"model\": \"speech-02-hd\",\n    \"text\": \"真正的危险不是计算机开始像人一样思考，而是人开始像计算机一样思考。\",\n    \"voice_setting\": {\n        \"voice_id\": \"moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85\",\n        \"speed\": 1,\n        \"vol\": 1,\n        \"pitch\": 0\n    }\n}",
        "oasKey": "文本输入（基础）",
        "oasExtensions": "",
        "mediaType": "application/json"
      },
      {
        "name": "使用所有可选参数的文本输入",
        "value": "{\n    \"model\": \"speech-2.8-hd\",\n    \"text\": \"真正的危险不是计算机开始像人一样思考(sighs)，而是人开始像计算机一样思考。计算机只是可以帮我们处理一些简单事务。\",\n    \"language_boost\": \"auto\",\n    \"voice_setting\": {\n        \"voice_id\": \"audiobook_male_1\",\n        \"speed\": 1,\n        \"vol\": 1,\n        \"pitch\": 1,\n        \"emotion\": \"calm\"\n    },\n    \"pronunciation_dict\": {\n        \"tone\": [\n            \"危险/dangerous\"\n        ]\n    },\n    \"audio_setting\": {\n        \"audio_sample_rate\": 32000,\n        \"bitrate\": 128000,\n        \"format\": \"mp3\",\n        \"channel\": 2\n    },\n    \"voice_modify\": {\n        \"pitch\": 0,\n        \"intensity\": 0,\n        \"timbre\": 0,\n        \"sound_effects\": \"spacious_echo\"\n    },\n    \"aigc_watermark\": false\n}",
        "oasKey": "文本输入（完整参数）",
        "oasExtensions": "",
        "mediaType": "application/json"
      },
      {
        "name": "使用 TXT 文件 ID 作为输入",
        "value": "{\n    \"model\": \"speech-2.8-hd\",\n    \"text_file_id\": 123456789,\n    \"language_boost\": \"Chinese\",\n    \"voice_setting\": {\n        \"voice_id\": \"audiobook_male_1\",\n        \"speed\": 1.2,\n        \"vol\": 1.5,\n        \"pitch\": 0\n    },\n    \"pronunciation_dict\": {\n        \"tone\": [\n            \"草地/(cao3)(di1)\"\n        ]\n    },\n    \"audio_setting\": {\n        \"audio_sample_rate\": 44100,\n        \"bitrate\": 256000,\n        \"format\": \"flac\",\n        \"channel\": 2\n    }\n}",
        "oasKey": "文件输入（TXT）",
        "oasExtensions": "",
        "mediaType": "application/json"
      },
      {
        "name": "使用 ZIP 压缩包批量处理",
        "value": "{\n    \"model\": \"speech-2.8-turbo\",\n    \"text_file_id\": 987654321,\n    \"voice_setting\": {\n        \"voice_id\": \"English_Graceful_Lady\",\n        \"speed\": 1,\n        \"vol\": 1\n    },\n    \"audio_setting\": {\n        \"format\": \"mp3\",\n        \"bitrate\": 128000\n    }\n}",
        "oasKey": "文件输入（ZIP批量）",
        "oasExtensions": "",
        "mediaType": "application/json"
      },
      {
        "name": "处理长文本（接近 5 万字符限制）",
        "value": "{\n    \"model\": \"speech-2.8-hd\",\n    \"text\": \"这是一段很长的文本内容...\",\n    \"voice_setting\": {\n        \"voice_id\": \"Chinese (Mandarin)_Lyrical_Voice\",\n        \"speed\": 1\n    }\n}",
        "oasKey": "长文本输入",
        "oasExtensions": "",
        "mediaType": "application/json"
      }
    ],
    "mediaType": "application/json",
    "oasExtensions": "",
    "required": true,
    "additionalContentTypes": []
  },
  "parameters": {
    "path": [],
    "query": [],
    "cookie": [],
    "header": [
      {
        "id": "vnBVfqnKyb",
        "name": "Content-Type",
        "required": true,
        "enable": true,
        "description": "请求体的媒介类型，必须设置为 application/json 以确保请求数据的格式为 JSON",
        "type": "string",
        "schema": {
          "type": "string",
          "enum": [
            "application/json"
          ],
          "default": "application/json"
        },
        "sampleValue": ""
      }
    ]
  },
  "commonParameters": {
    "query": [],
    "body": [],
    "cookie": [],
    "header": []
  },
  "auth": {
    "type": "inherit",
    "inherit": {}
  },
  "responses": [
    {
      "id": 177419213,
      "name": "成功",
      "code": 200,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {},
        "x-apifox-orders": []
      },
      "itemSchema": {},
      "description": "任务创建成功，返回任务 ID 和相关信息",
      "mediaType": "application/json",
      "headers": [],
      "oasExtensions": ""
    },
    {
      "id": 111700610,
      "name": "请求有误",
      "code": 400,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {},
        "x-apifox-orders": []
      },
      "itemSchema": {},
      "description": "请求参数错误",
      "mediaType": "application/json",
      "headers": [],
      "oasExtensions": ""
    },
    {
      "id": 141827448,
      "name": "没有权限",
      "code": 401,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {},
        "x-apifox-orders": []
      },
      "itemSchema": {},
      "description": "鉴权失败",
      "mediaType": "application/json",
      "headers": [],
      "oasExtensions": ""
    },
    {
      "id": 185660167,
      "name": "禁止访问",
      "code": 429,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {},
        "x-apifox-orders": []
      },
      "itemSchema": {},
      "description": "触发限流",
      "mediaType": "application/json",
      "headers": [],
      "oasExtensions": ""
    }
  ],
  "responseExamples": [
    {
      "name": "任务成功创建的标准响应",
      "responseId": 177419213,
      "data": "{\n    \"task_id\": \"95157322514444\",\n    \"task_token\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...\",\n    \"file_id\": 95157322514444,\n    \"usage_characters\": 101,\n    \"base_resp\": {\n        \"status_code\": 0,\n        \"status_msg\": \"success\"\n    }\n}",
      "description": "",
      "oasKey": "任务创建成功",
      "oasExtensions": "",
      "id": "019fc09b-0b2e-723f-adf0-e0890043fe9e"
    },
    {
      "name": "参数错误",
      "responseId": 111700610,
      "data": "{\n    \"base_resp\": {\n        \"status_code\": 2013,\n        \"status_msg\": \"参数错误：text 和 text_file_id 必须提供其中之一\"\n    }\n}",
      "description": "",
      "oasKey": "参数错误",
      "oasExtensions": "",
      "id": "019fc09b-0b2e-723f-adf0-e57a7828e348"
    },
    {
      "name": "鉴权失败",
      "responseId": 141827448,
      "data": "{\n    \"base_resp\": {\n        \"status_code\": 1004,\n        \"status_msg\": \"鉴权失败，请检查 API-Key 是否正确\"\n    }\n}",
      "description": "",
      "oasKey": "鉴权失败",
      "oasExtensions": "",
      "id": "019fc09b-0b2e-723f-adf0-ebbb3801a918"
    },
    {
      "name": "触发限流",
      "responseId": 185660167,
      "data": "{\n    \"base_resp\": {\n        \"status_code\": 1002,\n        \"status_msg\": \"触发限流，请稍后再试\"\n    }\n}",
      "description": "",
      "oasKey": "触发限流",
      "oasExtensions": "",
      "id": "019fc09b-0b2e-723f-adf0-ef7f02afdc4b"
    }
  ],
  "codeSamples": [],
  "projectId": 8662722,
  "moduleId": 8310462,
  "folderId": 92436087,
  "ordering": 0,
  "responsibleId": 0,
  "commonResponseStatus": {},
  "advancedSettings": {
    "disabledSystemHeaders": {}
  },
  "customApiFields": {},
  "oasExtensions": "",
  "mockScript": {},
  "createdAt": "2026-08-02T03:53:34.000Z",
  "updatedAt": "2026-08-06T12:15:55.000Z",
  "creatorId": 2863449,
  "editorId": 2863449,
  "creatorUserId": 2863449,
  "editorUserId": 2863449,
  "responseChildren": [],
  "visibility": "INHERITED",
  "securityScheme": {},
  "callbacks": ""
}