Skip to main content
POST
Qwen3 TTS Voice Clone

Headers

Authorization
string

Body

application/json
model
enum<string>
required

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

Available options:
qwen3-tts-voice-clone
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
reference_audio_url
string<uri>
required

Required. Public HTTPS URL of the voice to clone. Max 50MB. Common audio formats (mp3, wav, m4a, aac, ogg, flac) and video files (the audio track is used) are accepted. Needs at least 2 seconds of speech. Unreachable or oversized links are rejected before any tokens are charged; if the file turns out not to be audio or contains no speech, the task fails and is refunded.

Example:

"https://your-cdn.com/voice-sample.mp3"

reference_text
string

Optional. The exact words spoken in the reference recording. When given, it must match the recording word for word, and the whole recording is used (up to 60 seconds). When omitted, the first 20 seconds or less (cut at a natural pause) are used and transcribed automatically.

Maximum string length: 1000
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