Skip to main content
POST
Qwen3 TTS

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be qwen3-tts.

Available options:
qwen3-tts
text
string
required

Text to synthesize. Required. Max 5000 characters. Billing is based on this length. Long texts are read in sentence-sized parts and joined into one file, so a single request can cover a whole article.

Required string length: 1 - 5000
voice
enum<string>
default:Vivian

Preset voice. Optional — defaults to Vivian. Case-insensitive. See the voice table above for what each one sounds like.

Available options:
Vivian,
Serena,
Uncle_Fu,
Dylan,
Eric,
Ryan,
Aiden,
Ono_Anna,
Sohee
style
string

Optional. A short natural-language instruction for the delivery — tone, emotion or pace, e.g. speak in a cheerful, excited tone, 用特别愤怒的语气说, speaking slowly and calmly. Leave it out for a natural read. There is no speed parameter; describe the pace here instead.

Maximum string length: 500
language
enum<string>
default:auto

Language of text. Optional — defaults to auto. Case-insensitive; the two-letter codes are accepted too. Supported: Chinese, English, Japanese, Korean, German, French, Russian, Portuguese, Spanish and Italian. Setting it explicitly when you know the language gives the most stable result.

Available options:
auto,
chinese,
english,
japanese,
korean,
german,
french,
russian,
portuguese,
spanish,
italian,
zh,
en,
ja,
ko,
de,
fr,
ru,
pt,
es,
it
output_format
enum<string>
default:mp3

Audio format. Optional — mp3 (default, 128 kbps) or wav (16-bit). Both are 24 kHz mono.

Available options:
mp3,
wav
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required