Non-real-time speech synthesis - Alibaba Cloud Model Studio

Convert complete text to speech over HTTP. Explore model features, make your first request, and improve synthesis quality.

Features

Non-real-time speech synthesis accepts complete text in one HTTP request and supports non-streaming and SSE streaming output. Non-streaming output returns an audio URL that is valid for 24 hours. Download and save the audio before the URL expires, or synthesize it again afterward. Streaming output returns audio in chunks.

Languages and dialects: Select a model and voice for the target language, or use an instruction to specify a dialect. See Dialects.
Expressive speech: Adjust delivery with natural-language instructions, or insert emotion and nonverbal tags into the text. See Instruction control and Emotion and nonverbal tags.
Custom voices: Create a voice from an audio sample with voice cloning, or from a text description with voice design.
Fine-grained control and formulas: Use SSML and LaTeX to control pauses and pronunciation, or convert formulas to speech.

Note

Supported features vary by model and voice. Check the scope in the corresponding feature documentation.
To submit text incrementally, use real-time speech synthesis.

Get started

Obtain an API key and set the environment variable DASHSCOPE_API_KEY. Use a key for the region in the example.
For a workspace-specific endpoint, replace YOUR_WORKSPACE_ID with the workspace ID for that region.
Install the example dependency:
```
pip install requests
```

Qwen-Audio-TTS (Recommended)

The following examples use qwen-audio-3.1-tts-flash and the longanhuan_v3.1 system voice in Singapore to demonstrate non-streaming and streaming output.

Non-streaming output

import os
import requests

response = requests.post(
    'https://YOUR_WORKSPACE_ID.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer',
    headers={"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"},
    json={
        "model": "qwen-audio-3.1-tts-flash",
        "input": {
            "text": "Hello, welcome to Alibaba Cloud Model Studio.",
            "voice": "longanhuan_v3.1",
            "format": "wav",
            "sample_rate": 24000
        }
    },
    timeout=60,
)
response.raise_for_status()
audio_url = response.json()["output"]["audio"]["url"]
audio_response = requests.get(audio_url, timeout=60)
audio_response.raise_for_status()
with open("output.wav", "wb") as f:
    f.write(audio_response.content)

The audio is saved as output.wav in the current directory.

Streaming output

This example prints the returned SSE events line by line. The output.audio.data field contains a Base64-encoded audio chunk.

import os
import requests

response = requests.post(
    'https://YOUR_WORKSPACE_ID.ap-southeast-1.maas.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer',
    headers={"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}", "X-DashScope-SSE": "enable"},
    json={
        "model": "qwen-audio-3.1-tts-flash",
        "input": {
            "text": "Hello, welcome to Alibaba Cloud Model Studio.",
            "voice": "longanhuan_v3.1",
            "format": "wav",
            "sample_rate": 24000
        }
    },
    stream=True,
    timeout=60,
)
response.raise_for_status()
for line in response.iter_lines():
    print(line.decode("utf-8"))
response.close()

CosyVoice

The following examples use cosyvoice-v3-flash and the longanyang system voice in Beijing to demonstrate non-streaming and streaming output.

Non-streaming output

import os
import requests

response = requests.post(
    'https://YOUR_WORKSPACE_ID.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer',
    headers={"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"},
    json={
        "model": "cosyvoice-v3-flash",
        "input": {
            "text": "Hello, welcome to Alibaba Cloud Model Studio.",
            "voice": "longanyang",
            "format": "wav",
            "sample_rate": 24000
        }
    },
    timeout=60,
)
response.raise_for_status()
audio_url = response.json()["output"]["audio"]["url"]
audio_response = requests.get(audio_url, timeout=60)
audio_response.raise_for_status()
with open("output.wav", "wb") as f:
    f.write(audio_response.content)

The audio is saved as output.wav in the current directory.

Streaming output

This example prints the returned SSE events line by line. The output.audio.data field contains a Base64-encoded audio chunk.

import os
import requests

response = requests.post(
    'https://YOUR_WORKSPACE_ID.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer',
    headers={"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}", "X-DashScope-SSE": "enable"},
    json={
        "model": "cosyvoice-v3-flash",
        "input": {
            "text": "Hello, welcome to Alibaba Cloud Model Studio.",
            "voice": "longanyang",
            "format": "wav",
            "sample_rate": 24000
        }
    },
    stream=True,
    timeout=60,
)
response.raise_for_status()
for line in response.iter_lines():
    print(line.decode("utf-8"))
response.close()

Improve synthesis quality

Languages and pronunciation

If numbers, abbreviations, or symbols are pronounced incorrectly, use language_hints to specify the target synthesis language, or use hot_fix to customize pronunciation and text replacement. For supported models and configuration, see the Qwen-Audio-TTS API or CosyVoice API.

Use SSML to control pauses, the reading of numbers, or word pronunciation. For supported Qwen-Audio-TTS and CosyVoice models, voices, interfaces, and tags, see SSML and LaTeX.

Instruction control

Add instruction to the request’s input object and describe the speech rate, emotion, or speaking style in natural language to control the synthesized speech.

NoteTo create a new voice with a specific gender, age, or vocal character, or for guidance and examples on writing voice descriptions, see voice design.

Qwen-Audio-TTS

System, cloned, and designed voices for qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, and qwen-audio-3.0-tts-flash all support natural-language instructions through instruction in synthesis requests.

To slow down the speech in the Qwen-Audio-TTS getting started example, add this field to input:

{"instruction": "请用非常缓慢的语速说话，每个字都慢慢说。"}

CosyVoice

NoteFor CosyVoice, instruction must not exceed 100 characters. Chinese characters, including simplified and traditional characters and Chinese characters used in Japanese and Korean, count as two characters each. Other characters, including punctuation, letters, digits, kana, and Hangul, count as one each.

Model	Applicable voices	Instruction requirements	Instruction text languages
`cosyvoice-v3.5-plus`, `cosyvoice-v3.5-flash`	Cloned and designed voices No system voices.	Natural-language instructions.	Chinese, English, French, German, Japanese, Korean, Russian, Portuguese, Thai, Indonesian, and Vietnamese.
`cosyvoice-v3-plus`	System voices	Use the fixed format and content in the voice list. Cloned and designed voices do not support instruction control.	Use the language specified in the voice list.
`cosyvoice-v3-flash`	System voices	Use the fixed format and content in the voice list.	Chinese.
`cosyvoice-v3-flash`	Cloned and designed voices	Natural-language instructions.	Chinese, English, French, German, Japanese, Korean, and Russian.

Dialects

Use dialect synthesis to generate speech in Chinese dialects such as Henan or Sichuan dialect. How you select a dialect depends on the model and voice type.

Qwen-Audio-TTS

System voices: Select a voice from the Qwen-Audio-TTS voice list that supports the dialect. A voice that directly supports the dialect requires no additional setting. For voices that support dialect instructions, use instruction.
Cloned voices: Specify a dialect with instruction, such as 请用河南话表达。.
Designed voices: Dialects are not supported.

CosyVoice

System voices: Select a voice that directly supports the dialect, such as longshange_v3, or a voice that supports dialect instructions, such as longanhuan_v3. Follow the format in the voice list.
Cloned voices: Use instruction with a model that supports instruction control to specify a dialect.
Designed voices: Dialects are not supported.

NoteCloned voices for cosyvoice-v3-plus do not support specifying a dialect through instructions.

In the CosyVoice getting started example, replace input with the following content to generate the Henan dialect with longanhuan_v3:

{
  "text": "叫你去买盐，你买回来一袋面，这不是弄啥嘞吗！",
  "voice": "longanhuan_v3",
  "format": "wav",
  "sample_rate": 24000,
  "instruction": "请用河南话表达。"
}

Qwen3-TTS uses system voices that support the target dialect. See the Qwen3-TTS voice list.

Emotion and nonverbal tags

NoteApplies to qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, and qwen-audio-3.0-tts-flash.

Emotion and paralinguistic tags control the emotion and style of speech and insert sounds such as laughter or sighs at specific positions. Write the tags directly in the text to synthesize, text, without additional parameters.

Usage examples

This text starts with an excited delivery, inserts laughter, and then continues speaking:

[excited]今天的天气真不错！[laughing]我们一起出去玩吧！

This text switches to an excited delivery in the second sentence:

[serious]请注意安全事项。[excited]好了，现在让我们开始吧！

Supported tags

Control tags

A control tag sets the emotion or style of the following text until the next control tag. When long sentences are automatically segmented, the effect is bounded by the resulting text segment.

Tag	Description
`[sad]`	Sad
`[amazed]`	Amazed
`[deep and loud shouting]`	Deep, loud shouting
`[trembling]`	Trembling
`[angry]`	Angry
`[excited]`	Excited
`[sarcastic]`	Sarcastic
`[curious]`	Curious
`[like dracula]`	Dracula-like delivery
`[bored]`	Bored
`[tired]`	Tired
`[scornful]`	Scornful
`[shouting]`	Shouting
`[asmr]`	Soft ASMR delivery
`[panicked]`	Panicked
`[mischievously]`	Mischievous
`[empathetic]`	Empathetic
`[whispers]`	Whispering
`[reluctantly]`	Reluctant
`[crying]`	Crying
`[serious]`	Serious
`[very slowly]`	Very slow
`[very fast]`	Very fast

Nonverbal tags

A nonverbal tag inserts a sound at its position without changing the emotional style of the surrounding text.

Tag	Description
`[gasp]`	Gasp
`[sighing]`	Sigh
`[clears throat]`	Clear the throat
`[giggles]`	Giggle
`[laughing]`	Laugh
`[cough]`	Cough
`[snorts]`	Snort

Supported models

Singapore

Use an API key and an endpoint for this region to call these models:

Qwen-Audio-TTS: qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash
Qwen3-TTS: qwen3-tts-flash

China (Beijing)

Use an API key and an endpoint for this region to call these models:

Qwen-Audio-TTS: qwen-audio-3.1-tts-flash, qwen-audio-3.0-tts-plus, qwen-audio-3.0-tts-flash
CosyVoice: cosyvoice-v3.5-plus, cosyvoice-v3.5-flash, cosyvoice-v3-plus, cosyvoice-v3-flash, cosyvoice-v2
Qwen3-TTS: qwen3-tts-flash

For system voices and audio samples, see the Qwen-Audio-TTS, CosyVoice, and Qwen3-TTS voice lists. A cloned or designed voice must be used with the target model specified when the voice was created.

Alibaba Cloud Model Studio:Non-real-time speech synthesis

Features

Get started

Qwen-Audio-TTS (Recommended)

Non-streaming output

Streaming output

CosyVoice

Non-streaming output

Streaming output

Improve synthesis quality

Languages and pronunciation

Instruction control

Qwen-Audio-TTS

CosyVoice

Dialects

Qwen-Audio-TTS

CosyVoice

Emotion and nonverbal tags

Usage examples

Supported tags

Control tags

Nonverbal tags

Supported models

Singapore

China (Beijing)

API reference