# MiniMax Speech 2.8 Turbo Async Text-to-Speech - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/api-reference/model-apis-minimax-speech-2.8-turbo-async

# MiniMax Speech 2.8 Turbo Async Text-to-Speech

POST

/

v3

/

async

/

minimax-speech-2.8-turbo

MiniMax Speech 2.8 Turbo Async Text-to-Speech

cURL

```
curl --request POST \
--url https://api.novita.ai/v3/async/minimax-speech-2.8-turbo \
--header 'Authorization: <authorization>' \
--header 'Content-Type: <content-type>' \
--data '
{
"text": "<string>",
"text_file_id": 123,
"voice_modify": {
"pitch": 123,
"timbre": 123,
"intensity": 123,
"sound_effects": "<string>"
},
"audio_setting": {
"format": "<string>",
"bitrate": 123,
"channel": 123,
"audio_sample_rate": 123
},
"voice_setting": {
"vol": 123,
"pitch": 123,
"speed": 123,
"emotion": "<string>",
"voice_id": "<string>",
"english_normalization": true
},
"aigc_watermark": true,
"language_boost": "<string>",
"pronunciation_dict": {
"tone": [
"<string>"
]
}
}
'
```

```
import requestsurl = "https://api.novita.ai/v3/async/minimax-speech-2.8-turbo"payload = { "text": "<string>", "text_file_id": 123, "voice_modify": { "pitch": 123, "timbre": 123, "intensity": 123, "sound_effects": "<string>" }, "audio_setting": { "format": "<string>", "bitrate": 123, "channel": 123, "audio_sample_rate": 123 }, "voice_setting": { "vol": 123, "pitch": 123, "speed": 123, "emotion": "<string>", "voice_id": "<string>", "english_normalization": True }, "aigc_watermark": True, "language_boost": "<string>", "pronunciation_dict": { "tone": ["<string>"] }}headers = { "Content-Type": "<content-type>", "Authorization": "<authorization>"}response = requests.post(url, json=payload, headers=headers)print(response.text)
```

```
const options = { method: 'POST', headers: {'Content-Type': '<content-type>', Authorization: '<authorization>'}, body: JSON.stringify({ text: '<string>', text_file_id: 123, voice_modify: {pitch: 123, timbre: 123, intensity: 123, sound_effects: '<string>'}, audio_setting: {format: '<string>', bitrate: 123, channel: 123, audio_sample_rate: 123}, voice_setting: { vol: 123, pitch: 123, speed: 123, emotion: '<string>', voice_id: '<string>', english_normalization: true }, aigc_watermark: true, language_boost: '<string>', pronunciation_dict: {tone: ['<string>']} })};fetch('https://api.novita.ai/v3/async/minimax-speech-2.8-turbo', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err));
```

```
<?php$curl = curl_init();curl_setopt_array($curl, [ CURLOPT_URL => "https://api.novita.ai/v3/async/minimax-speech-2.8-turbo", CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => "", CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 30, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ 'text' => '<string>', 'text_file_id' => 123, 'voice_modify' => [ 'pitch' => 123, 'timbre' => 123, 'intensity' => 123, 'sound_effects' => '<string>' ], 'audio_setting' => [ 'format' => '<string>', 'bitrate' => 123, 'channel' => 123, 'audio_sample_rate' => 123 ], 'voice_setting' => [ 'vol' => 123, 'pitch' => 123, 'speed' => 123, 'emotion' => '<string>', 'voice_id' => '<string>', 'english_normalization' => true ], 'aigc_watermark' => true, 'language_boost' => '<string>', 'pronunciation_dict' => [ 'tone' => [ '<string>' ] ] ]), CURLOPT_HTTPHEADER => [ "Authorization: <authorization>", "Content-Type: <content-type>" ],]);$response = curl_exec($curl);$err = curl_error($curl);curl_close($curl);if ($err) { echo "cURL Error #:" . $err;} else { echo $response;}
```

```
package mainimport (	"fmt"	"strings"	"net/http"	"io")func main() {	url := "https://api.novita.ai/v3/async/minimax-speech-2.8-turbo"	payload := strings.NewReader("{\n \"text\": \"<string>\",\n \"text_file_id\": 123,\n \"voice_modify\": {\n \"pitch\": 123,\n \"timbre\": 123,\n \"intensity\": 123,\n \"sound_effects\": \"<string>\"\n },\n \"audio_setting\": {\n \"format\": \"<string>\",\n \"bitrate\": 123,\n \"channel\": 123,\n \"audio_sample_rate\": 123\n },\n \"voice_setting\": {\n \"vol\": 123,\n \"pitch\": 123,\n \"speed\": 123,\n \"emotion\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"english_normalization\": true\n },\n \"aigc_watermark\": true,\n \"language_boost\": \"<string>\",\n \"pronunciation_dict\": {\n \"tone\": [\n \"<string>\"\n ]\n }\n}")	req, _ := http.NewRequest("POST", url, payload)	req.Header.Add("Content-Type", "<content-type>")	req.Header.Add("Authorization", "<authorization>")	res, _ := http.DefaultClient.Do(req)	defer res.Body.Close()	body, _ := io.ReadAll(res.Body)	fmt.Println(string(body))}
```

```
HttpResponse<String> response = Unirest.post("https://api.novita.ai/v3/async/minimax-speech-2.8-turbo") .header("Content-Type", "<content-type>") .header("Authorization", "<authorization>") .body("{\n \"text\": \"<string>\",\n \"text_file_id\": 123,\n \"voice_modify\": {\n \"pitch\": 123,\n \"timbre\": 123,\n \"intensity\": 123,\n \"sound_effects\": \"<string>\"\n },\n \"audio_setting\": {\n \"format\": \"<string>\",\n \"bitrate\": 123,\n \"channel\": 123,\n \"audio_sample_rate\": 123\n },\n \"voice_setting\": {\n \"vol\": 123,\n \"pitch\": 123,\n \"speed\": 123,\n \"emotion\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"english_normalization\": true\n },\n \"aigc_watermark\": true,\n \"language_boost\": \"<string>\",\n \"pronunciation_dict\": {\n \"tone\": [\n \"<string>\"\n ]\n }\n}") .asString();
```

```
require 'uri'require 'net/http'url = URI("https://api.novita.ai/v3/async/minimax-speech-2.8-turbo")http = Net::HTTP.new(url.host, url.port)http.use_ssl = truerequest = Net::HTTP::Post.new(url)request["Content-Type"] = '<content-type>'request["Authorization"] = '<authorization>'request.body = "{\n \"text\": \"<string>\",\n \"text_file_id\": 123,\n \"voice_modify\": {\n \"pitch\": 123,\n \"timbre\": 123,\n \"intensity\": 123,\n \"sound_effects\": \"<string>\"\n },\n \"audio_setting\": {\n \"format\": \"<string>\",\n \"bitrate\": 123,\n \"channel\": 123,\n \"audio_sample_rate\": 123\n },\n \"voice_setting\": {\n \"vol\": 123,\n \"pitch\": 123,\n \"speed\": 123,\n \"emotion\": \"<string>\",\n \"voice_id\": \"<string>\",\n \"english_normalization\": true\n },\n \"aigc_watermark\": true,\n \"language_boost\": \"<string>\",\n \"pronunciation_dict\": {\n \"tone\": [\n \"<string>\"\n ]\n }\n}"response = http.request(request)puts response.read_body
```

200

```
{
"file_id": 123,
"task_id": "<string>",
"base_resp": {
"status_msg": "<string>",
"status_code": 123
},
"task_token": "<string>",
"usage_characters": 123
}
```

MiniMax asynchronous text-to-speech API, supports various voice, emotion, speed and other parameter settings, text length limit up to 50,000 characters, supports file input (up to 100,000 characters)

This is an asynchronous API; only the task_id will be returned. You should use the task_id to request the [Task Result API](/docs/api-reference/model-apis-task-result) to retrieve the video generation results.

##

[​](#request-headers)

Request Headers

[​](#param-content-type)

Content-Type

string

required

Supports: `application/json`

[​](#param-authorization)

Authorization

string

required

Bearer authentication format, for example: Bearer {{API Key}}.

##

[​](#request-body)

Request Body

[​](#param-text)

text

string

Text to synthesize into audio, maximum length is 50,000 characters. Either `text` or `text_file_id` is required.

• Interjection tags: Only supported when model is `speech-2.8-hd` or `speech-2.8-turbo`. Supported interjections: `(laughs)` (laughter), `(chuckle)` (light laugh), `(coughs)` (cough), `(clear-throat)` (clear throat), `(groans)` (groan), `(breath)` (normal breathing), `(pant)` (panting), `(inhale)` (inhale), `(exhale)` (exhale), `(gasps)` (gasp), `(sniffs)` (sniff), `(sighs)` (sigh), `(snorts)` (snort), `(burps)` (burp), `(lip-smacking)` (lip smacking), `(humming)` (humming), `(hissing)` (hissing), `(emm)` (um), `(whistles)` (whistle), `(sneezes)` (sneeze), `(crying)` (crying), `(applause)` (applause)

[​](#param-text-file-id)

text_file_id

integer

Text file ID for audio synthesis, single file length limit is less than 100,000 characters, supported file formats: txt, zip. Either `text` or `text_file_id` is required, format will be automatically validated.
• txt file: Length limit <100000 characters. Supports custom pause using `<#x#>` tag. x is pause duration (in seconds), range [0.01, 99.99], up to 2 decimal places. Pause must be set between two pronounceable text segments, cannot use multiple pause tags consecutively
• zip file:
• Compressed package must contain txt or json files of the same format.
• json file format: Supports [`title`, `content`, `extra`] three fields, representing title, body, and additional information. If all three fields exist, 3 groups of results will be produced, 9 files in total, stored in one folder. If a field does not exist or is empty, no corresponding result will be generated

[​](#param-voice-modify)

voice_modify

object

Hide properties

[​](#param-pitch)

pitch

integer

Pitch adjustment (deep/bright), range [-100, 100], values closer to -100 produce deeper voice; closer to 100 produce brighter voiceValue range: [-100, 100]

[​](#param-timbre)

timbre

integer

Timbre adjustment (rich/crisp), range [-100, 100], values closer to -100 produce richer voice; closer to 100 produce crisper voiceValue range: [-100, 100]

[​](#param-intensity)

intensity

integer

Intensity adjustment (powerful/soft), range [-100, 100], values closer to -100 produce more powerful voice; closer to 100 produce softer voiceValue range: [-100, 100]

[​](#param-sound-effects)

sound_effects

string

Sound effect setting, only one can be selected at a time. Options:

- spacious_echo (spacious echo)

- auditorium_echo (auditorium broadcast)

- lofi_telephone (telephone distortion)

- robotic (electronic)

Optional values: `spacious_echo`, `auditorium_echo`, `lofi_telephone`, `robotic`

[​](#param-audio-setting)

audio_setting

object

Hide properties

[​](#param-format)

format

string

default:"mp3"

Audio output format. Options `[mp3, pcm, flac]`, default is `mp3`Optional values: `mp3`, `pcm`, `flac`

[​](#param-bitrate)

bitrate

integer

default:128000

Audio bitrate. Options `[32000, 64000, 128000, 256000]`, default is `128000`. This parameter only applies to `mp3` format

[​](#param-channel)

channel

integer

default:2

Number of audio channels. Options: `[1, 2]`, where `1` is mono and `2` is stereo, default is 1

[​](#param-audio-sample-rate)

audio_sample_rate

integer

default:32000

Audio sample rate. Options `[8000, 16000, 22050, 24000, 32000, 44100]`, default is `32000`

[​](#param-voice-setting)

voice_setting

object

required

Hide properties

[​](#param-vol)

vol

number

default:1

Audio volume, higher value means louder. Range (0, 10], default is 1.0Value range: [0, 10]

[​](#param-pitch-1)

pitch

integer

default:0

Audio pitch, range `[-12, 12]`, default is 0, where 0 is original voice outputValue range: [-12, 12]

[​](#param-speed)

speed

number

default:1

Speech speed, higher value means faster. Range `[0.5, 2]`, default is 1.0Value range: [0.5, 2]

[​](#param-emotion)

emotion

string

Controls the emotion of synthesized speech. Options `["happy", "sad", "angry", "fearful", "disgusted", "surprised", "calm", "fluent", "whisper"]` correspond to 8 emotions: happy, sad, angry, fearful, disgusted, surprised, calm, fluent, whisper

• The model will automatically match appropriate emotion based on input text, usually no need to specify manually

• This parameter only works for `speech-2.6-hd`, `speech-2.6-turbo`, `speech-02-hd`, `speech-02-turbo`, `speech-01-hd`, `speech-01-turbo` models

• Options `fluent`, `whisper` only work for `speech-2.6-turbo`, `speech-2.6-hd` modelsOptional values: `happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`, `calm`, `fluent`, `whisper`

[​](#param-voice-id)

voice_id

string

required

Voice ID for audio synthesis. If mixed voice is needed, set timber_weights parameter and leave this empty. Supports system voice, cloned voice, and text-generated voice. Below are some of the latest system voices (ID)

• Chinese:
• moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85
• moss_audio_aaa1346a-7ce7-11f0-8e61-2e6e3c7ee85d
• Chinese (Mandarin)_Lyrical_Voice
• Chinese (Mandarin)_HK_Flight_Attendant
• English:
• English_Graceful_Lady
• English_Insightful_Speaker
• English_radiant_girl
• English_Persuasive_Man
• moss_audio_6dc281eb-713c-11f0-a447-9613c873494c
• moss_audio_570551b1-735c-11f0-b236-0adeeecad052
• moss_audio_ad5baf92-735f-11f0-8263-fe5a2fe98ec8
• English_Lucky_Robot
• Japanese:
• Japanese_Whisper_Belle
• moss_audio_24875c4a-7be4-11f0-9359-4e72c55db738
• moss_audio_7f4ee608-78ea-11f0-bb73-1e2a4cfcd245
• moss_audio_c1a6a3ac-7be6-11f0-8e8e-36b92fbb4f95

[​](#param-english-normalization)

english_normalization

boolean

default:false

Supports English text normalization, which can improve performance in number reading scenarios but slightly increases latency, default false

[​](#param-aigc-watermark)

aigc_watermark

boolean

default:false

Controls whether to add audio rhythm identifier at the end of synthesized audio, default is False. This parameter is only valid for non-streaming synthesis

[​](#param-language-boost)

language_boost

string

Whether to enhance recognition ability for specified minor languages and dialects. Default is `null`, can be set to `auto` to let the model decide automatically.Optional values: `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`

[​](#param-pronunciation-dict)

pronunciation_dict

object

Hide properties

[​](#param-tone)

tone

string[]

Defines pronunciation or replacement rules for special characters or symbols. For Chinese text, tones are represented by numbers:
1st tone = 1, 2nd tone = 2, 3rd tone = 3, 4th tone = 4, neutral tone = 5
Example:
`["omg/oh my god"]`

##

[​](#response)

Response

[​](#param-file-id)

file_id

integer

Corresponding audio file ID returned after task creation.

. This field is not returned when request failsNote: The download URL is valid for 9 hours (32400 seconds) from generation. After expiration, the file will become invalid and generated information will be lost. Please pay attention to download timing

[​](#param-task-id)

task_id

string

Use the task_id to retrieve the generated outputs.

[​](#param-base-resp)

base_resp

object

Hide properties

[​](#param-status-msg)

status_msg

string

required

Status details

[​](#param-status-code)

status_code

integer

required

Status code

• `0`: Success
• `1002`: Rate limit
• `1004`: Authentication failed
• `1039`: TPM rate limit triggered
• `1042`: Invalid characters exceed 10%
• `2013`: Parameter error

[​](#param-task-token)

task_token

string

Token used to complete the current task

[​](#param-usage-characters)

usage_characters

integer

Billable character count

Last modified on July 8, 2026