Skip to main content
POST
Qwen3 TTS Voice Design

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be qwen3-tts-voice-design.

Available options:
qwen3-tts-voice-design
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_description
string
required

Required. A description of the voice, e.g. a deep, husky middle-aged male voice, speaking slowly like a late-night radio host or 体现撒娇稚嫩的萝莉女声,音调偏高. Max 500 characters. There is no speed parameter; describe the pace here.

Required string length: 1 - 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