场景二：异步长文本语音合成

适用：文本较长的场景。提交后立即返回任务号，再通过查询接口取结果。

第一步 · 创建任务

POST 提交，立即返回 task_id、task_token、file_id 等信息：

curl

curl --request POST \
  --url https://api.allyang.cn/minimaxi/v1/t2a_async_v2 \
  --header 'Authorization: Bearer <API-Key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "speech-2.6-hd",
  "text": "真正的危险不是计算机开始像人一样思考，而是人开始像计算机一样思考。计算机只是可以帮我们处理一些简单事务。",
  "language_boost": "auto",
  "voice_setting": {
    "voice_id": "audiobook_male_1",
    "speed": 1,
    "vol": 1,
    "pitch": 1
  },
  "pronunciation_dict": {
    "tone": [
      "危险/dangerous"
    ]
  },
  "audio_setting": {
    "audio_sample_rate": 32000,
    "bitrate": 128000,
    "format": "mp3",
    "channel": 2
  },
  "voice_modify": {
    "pitch": 0,
    "intensity": 0,
    "timbre": 0,
    "sound_effects": "spacious_echo"
  }
}'

json

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

第二步 · 查询任务

用上一步的 task_id 轮询：

curl

curl --request GET \
  --url 'https://api.allyang.cn/minimaxi/v1/query/t2a_async_query_v2?task_id=95157322514444' \
  --header 'Authorization: Bearer <API-Key>'

json

{
  "task_id": 95157322514444,
  "status": "Processing",
  "file_id": 95157322514496,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

status 变为完成态后，用 file_id 取回音频文件。

待补：完成态取值枚举与文件下载路径（源文档未给出，发布前补实测）。