{
    "summary": "创建异步语音合成任务",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": {
                            "file_id": {
                                "type": "integer",
                                "description": "任务创建成功后返回的对应音频文件的 ID。\n\n当任务完成后，可通过 file_id 调用 文件检索接口 进行下载\n当请求出错时，不返回该字段 注意：返回的下载 URL 自生成起 9 小时（32,400 秒）内有效，过期后文件将失效，生成的信息便会丢失，请注意下载信息的时间"
                            },
                            "task_id": {
                                "type": "integer",
                                "description": "当前任务的 ID"
                            },
                            "base_resp": {
                                "type": "object",
                                "required": [
                                    "status_code",
                                    "status_msg"
                                ],
                                "properties": {
                                    "status_msg": {
                                        "type": "string",
                                        "description": "状态详情"
                                    },
                                    "status_code": {
                                        "type": "integer",
                                        "description": "状态码\n\n0: 正常\n1002: 限流\n1004: 鉴权失败\n1039: 触发 TPM 限流\n1042: 非法字符超10%\n2013: 参数错误"
                                    }
                                },
                                "description": "本次请求的状态码及其详情"
                            },
                            "task_token": {
                                "type": "string",
                                "description": "完成当前任务使用的密钥信息"
                            },
                            "usage_characters": {
                                "type": "integer",
                                "description": "计费字符数"
                            }
                        }
                    }
                }
            },
            "description": "成功"
        }
    },
    "parameters": [],
    "description": "### 创建异步语音合成任务\n[官方文档](\n\n通过 post 请求{{BASE_URL}}/minimaxi/v1/t2a_async_v2\n创建语音合成任务，并立即返回task_id等相关信息",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "创建异步语音合成任务",
                    "$schema": "",
                    "required": [
                        "model",
                        "text",
                        "voice_setting",
                        "text_file_id"
                    ],
                    "properties": {
                        "text": {
                            "type": "string",
                            "description": "待合成音频的文本，限制最长 5 万字符。和 text_file_id 二选一必填"
                        },
                        "model": {
                            "type": "string",
                            "description": "请求的模型版本，可选范围：speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd, speech-01-turbo."
                        },
                        "text_file_id": {
                            "type": "integer",
                            "description": "待合成音频的文本文件 待合成音频的文本文件 id，单个文件长度限制小于 10 万字符，支持的文件格式：txt、zip。和 text 二选一必填，传入后自动校验格式。\n\ntxt 文件：长度限制 <100,000 字符。支持使用 <#x#> 标记自定义停顿。x 为停顿时长（单位：秒），范围 [0.01,99.99]，最多保留两位小数。注意停顿需设置在两个可以语音发音的文本之间，不可连续使用多个停顿标记\nzip 文件：\n压缩包内需包含同一格式的 txt 或 json 文件。\njson 文件格式：支持 [title, content, extra] 三个字段，分别表示标题、正文、附加信息。若三个字段都存在，则产出 3 组结果，共 9 个文件，统一存放在一个文件夹中。若某字段不存在或内容为空，则该字段不会生成对应结果"
                        },
                        "voice_modify": {
                            "type": "object",
                            "properties": {
                                "pitch": {
                                    "type": "integer",
                                    "description": "音高调整（低沉/明亮），范围 [-100,100]，数值接近 -100，声音更低沉；接近 100，声音更明亮"
                                },
                                "timbre": {
                                    "type": "integer",
                                    "description": "音色调整（磁性/清脆），范围 [-100,100]，数值接近 -100，声音更浑厚；数值接近 100，声音更清脆"
                                },
                                "intensity": {
                                    "type": "integer",
                                    "description": "强度调整（力量感/柔和），范围 [-100,100]，数值接近 -100，声音更刚劲；接近 100，声音更轻柔"
                                },
                                "sound_effects": {
                                    "type": "string",
                                    "description": "音效设置，单次仅能选择一种，可选值：\n\nspacious_echo（空旷回音）\nauditorium_echo（礼堂广播）\nlofi_telephone（电话失真）\nrobotic（电音）\n可用选项: spacious_echo, auditorium_echo, lofi_telephone, robotic"
                                }
                            },
                            "description": "声音效果器设置"
                        },
                        "audio_setting": {
                            "type": "object",
                            "properties": {
                                "format": {
                                    "type": "string",
                                    "description": "生成音频的格式。可选范围[mp3, pcm, flac]，默认值为 mp3\n\n可用选项: mp3, pcm, flac"
                                },
                                "bitrate": {
                                    "type": "integer",
                                    "description": "生成音频的比特率。可选范围 [32000，64000，128000，256000]，默认值为 128000。该参数仅对 mp3 格式的音频生效"
                                },
                                "channel": {
                                    "type": "integer",
                                    "description": "生成音频的声道数。可选范围：[1,2]，其中 1 为单声道，2 为双声道，默认值为 1"
                                },
                                "audio_sample_rate": {
                                    "type": "integer",
                                    "description": "生成音频的采样率。可选范围 [8000，16000，22050，24000，32000，44100]，默认为 32000"
                                }
                            }
                        },
                        "voice_setting": {
                            "type": "object",
                            "required": [
                                "voice_id"
                            ],
                            "properties": {
                                "vol": {
                                    "type": "number",
                                    "description": "合成音频的音量，取值越大，音量越高。取值范围 (0,10]，默认值为 1.0"
                                },
                                "pitch": {
                                    "type": "integer",
                                    "description": "合成音频的语调，取值范围 [-12,12]，默认值为 0，其中 0 为原音色输出"
                                },
                                "speed": {
                                    "type": "number",
                                    "description": "合成音频的语速，取值越大，语速越快。取值范围 [0.5,2]，默认值为1.0"
                                },
                                "voice_id": {
                                    "type": "string",
                                    "description": "合成音频的音色编号。"
                                }
                            }
                        },
                        "aigc_watermark": {
                            "type": "boolean",
                            "description": "控制在合成音频的末尾添加音频节奏标识，默认值为 False。该参数仅对非流式合成生效"
                        },
                        "language_boost": {
                            "type": "string",
                            "description": "是否增强对指定的小语种和方言的识别能力。默认值为 null，可设置为 auto 让模型自主判断。\n\n可用选项: Chinese, Chinese,Yue, English, Arabic, Russian, Spanish, French, Portuguese, German, Turkish, Dutch, Ukrainian, Vietnamese, Indonesian, Japanese, Italian, Korean, Thai, Polish, Romanian, Greek, Czech, Finnish, Hindi, Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans, auto"
                        },
                        "pronunciation_dict": {
                            "type": "object",
                            "properties": {
                                "tone": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    },
                                    "description": "定义需要特殊标注的文字或符号对应的注音或发音替换规则。在中文文本中，声调用数字表示：\n一声为 1，二声为 2，三声为 3，四声为 4，轻声为 5\n示例如下：\n[\"燕少飞/(yan4)(shao3)(fei1)\", \"omg/oh my god\"]"
                                }
                            }
                        }
                    },
                    "x-apifox-id": "379965171"
                }
            }
        },
        "required": true
    }
}