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
object
required

Input object containing the text to synthesize and the voice.

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.