Skip to main content
POST

Authorizations

​
Authorization
string
header
required

Pass Authorization: Bearer <token> in the request header.

Headers

​
X-DashScope-SSE
enum<string>

Official Ali HTTP streaming switch. Send enable to receive text/event-stream.

Available options:
enable

Body

application/json
​
model
enum<string>
required

Model name. Available options: qwen3-tts-instruct-flash.

Available options:
qwen3-tts-instruct-flash
​
input
string
required

Text to synthesize. This field accepts multilingual input.

​
voice
enum<string>
required

Voice to use. See supported system voices.

Available options:
Cherry,
Serena,
Ethan,
Chelsie,
Momo,
Vivian,
Moon,
Maia,
Kai,
Nofish,
Bella,
Eldric Sage,
Mia,
Mochi,
Bellona,
Vincent,
Bunny,
Neil,
Elias,
Arthur,
Nini,
Seren,
Pip,
Stella
​
instructions
string

Sets instructions. See instruction control.

Default: none, no effect when not set. Maximum length: 1600 tokens. Supported languages: Chinese and English only. Scope: This feature is only supported by the qwen3-TTS-Instruct-Flash-Realtime series models.

​
optimize_instructions
boolean

Optimizes instructions semantically to improve the naturalness and expressiveness of voice synthesis.

Default: false. Behavior: When set to true, the system semantically enhances and rewrites the instructions content to generate internal instructions better suited for voice synthesis. Recommended for high-quality, refined voice expression. Depends on the instructions parameter. If instructions is empty, this parameter has no effect. Scope: This feature is only supported by the qwen3-TTS-Instruct-Flash series models.

​
language_type
enum<string>

Language type for the synthesized audio. Defaults to Auto.

  • Auto: Suitable when the text contains multiple languages or the language is uncertain. The model automatically matches pronunciation for different language segments, but accuracy is not guaranteed.
  • Specified language: Suitable for single-language text. Specifying a language significantly improves synthesis quality, generally outperforming Auto.
Available options:
Auto,
Chinese,
English,
German,
Italian,
Portuguese,
Spanish,
Japanese,
Korean,
French,
Russian

Response

Successful call. Non-streaming returns the official Ali JSON response; streaming returns Ali SSE payloads.

​
status_code
integer

HTTP status code. Follows RFC 9110 definitions. For example:

  • 200: Request successful, normal response returned
  • 400: Client request parameter error
  • 401: Unauthorized access
  • 404: Resource not found
  • 500: Internal server error
​
request_id
string

Unique request identifier for this request, useful for troubleshooting.

​
code
string

Error code. Returned when the request fails.

​
message
string

Error message. Returned when the request fails.

​
output
object

Model output.

​
usage
object

Token or character consumption for this request. qwen-TTS returns token consumption information, while qwen3-TTS-Flash returns character consumption information.