| text |
Text to synthesize. Required. Max 20,000 Unicode characters. Supports plain text and SSML (set enable_ssml to true) per Alibaba documentation. |
string |
Yes |
- |
| voice |
Voice ID for qwen-audio-3.0-tts-plus only. Use a Plus system voice (e.g. longanlingxin, longanlufeng) or a Plus base/cloned voice ID from the official Qwen-Audio-TTS voice list: https://help.aliyun.com/zh/model-studio/qwen-audio-tts-voice-list . Do not mix Flash system voices with Plus. |
string |
Yes |
- |
| aigc_propagate_id |
AIGC PropagateID. Only effective when enable_aigc_tag is true. |
string |
No |
- |
| aigc_propagator |
AIGC ContentPropagator. Only effective when enable_aigc_tag is true. |
string |
No |
- |
| instruction |
Optional speaking-style instruction. Enforced weighted length ≤100 (CJK ideographs / Han count as 2; other characters count as 1). |
string |
No |
- |
| bit_rate |
Audio bit rate in kbps. Optional. Range 6 to 510. Only supported when format is opus; do not use for mp3, pcm, or wav. |
integer |
No |
- |
| enable_aigc_tag |
Embed AIGC invisible watermark into wav/mp3/opus output. Supported on Qwen-Audio 3.0 TTS Plus and Flash. |
boolean |
No |
true, false |
| enable_ssml |
Whether to parse text as SSML. Default false. When true, text must follow Alibaba SpeechSynthesizer SSML rules. |
boolean |
No |
true, false |
| format |
Audio encoding format. Default mp3. |
string |
No |
mp3, pcm, wav, opus |
| language_hint |
Target language hint for pronunciation (numbers, symbols, minor languages). |
string |
No |
zh, en, fr, de, ja, ko, ru, pt, th, id, vi, es, it, ms, fil, ar |
| pitch |
Pitch multiplier. Default 1.0. Range 0.5 (lower) to 2.0 (higher). |
number |
No |
- |
| rate |
Speech rate multiplier. Default 1.0. Range 0.5 (slow) to 2.0 (fast). |
number |
No |
- |
| sample_rate |
Audio sample rate in Hz. Default 22050. |
integer |
No |
8000, 16000, 22050, 24000, 44100, 48000 |
| seed |
Random seed for reproducible synthesis when text, voice, and other parameters are identical. Default 0. Range 0 to 65535. |
integer |
No |
- |
| volume |
Output volume. Default 50. Range 0 (silent) to 100 (maximum). |
integer |
No |
- |