Skip to main content
POST
/
v1
/
predictions
curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen3-tts-flash",
  "function": "audio",
  "input": {
    "prompt": "At the jet bridge, Leo took his first step onto the metal walkway. He could smell faint fumes from the runway. The plane loomed ahead like a quiet animal. As he approached the door, he paused, gave the flight attendant a small smile, and entered the long, low-lit cabin.Engines roared. Leo grasped the armrest as the plane gathered speed and lifted into the sky. The city below shrank into a dim grid of lights. At cruising altitude, the engines settled into a low hum. The atmosphere outside felt thin and silent.",
    "voice": "Cherry",
    "language": "Auto"
  },
  "webhook": "https://api.shuyou.ai/backend/api/callback"
}
'
{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

Voice presets (input.voice)

Pass a voice preset name in input.voice. The table below lists Qwen TTS voices supported by qwen3-tts-flash (and related Qwen TTS model families).
voiceNameDescriptionLanguages
Cherry芊悦Sunny, upbeat, natural femaleMandarin, English, French, German, Russian, Italian, Spanish, Portuguese, Japanese, Korean
Serena苏瑶Gentle femaleSame as above
Ethan晨煦Warm, energetic male (Mandarin with slight northern accent)Same as above
Chelsie千雪Anime-style virtual girlfriend (female)Same as above
Momo茉兔Playful, teasing femaleSame as above
Vivian十三Cute but feisty femaleSame as above
Moon月白Cool, handsome maleSame as above
Maia四月Intellectual and gentle femaleSame as above
KaiSoothing maleSame as above
Nofish不吃鱼Designer male (non-retroflex accent)Same as above
Bella萌宝Cute young femaleSame as above
Jennifer詹妮弗Cinematic American femaleSame as above
Ryan甜茶Dramatic, expressive maleSame as above
Katerina卡捷琳娜Mature femaleSame as above
Aiden艾登American maleSame as above
Eldric Sage沧明子Wise elder maleSame as above
Mia乖小妹Obedient, gentle femaleSame as above
Mochi沙小弥Precocious young maleSame as above
Bellona燕铮莺Powerful, clear female (period drama style)Same as above
Vincent田叔Husky, gritty maleSame as above
Bunny萌小姬Very cute young femaleSame as above
Neil阿闻Professional news anchor maleSame as above
Elias墨讲师Educational female narratorSame as above
Arthur徐大爷Folksy storyteller maleSame as above
Nini邻家妹妹Sweet younger-sister femaleSame as above
Seren小婉Calm, sleep-aid femaleSame as above
Pip顽屁小孩Mischievous boySame as above
Stella少女阿月Sweet magical-girl femaleSame as above
Bodega博德加Warm Spanish uncle (male)Same as above
Sonrisa索尼莎Cheerful Latina femaleSame as above
Alek阿列克Russian maleSame as above
Dolce多尔切Laid-back Italian uncle (male)Same as above
Sohee素熙Warm Korean femaleSame as above
Ono Anna小野杏Feisty childhood-friend femaleSame as above
Lenn莱恩Rational German youth (male)Same as above
Emilien埃米尔安Romantic French maleSame as above
Andre安德雷Magnetic, steady maleSame as above
Radio Gol拉迪奥·戈尔Sports commentator maleSame as above
Jada上海-阿珍Shanghai dialect femaleShanghai dialect + same multilingual set
Dylan北京-晓东Beijing dialect maleBeijing dialect + same multilingual set
Li南京-老李Nanjing dialect maleNanjing dialect + same multilingual set
Marcus陕西-秦川Shaanxi dialect maleShaanxi dialect + same multilingual set
Roy闽南-阿杰Taiwanese Hokkien maleHokkien + same multilingual set
Peter天津-李彼得Tianjin dialect male (comic duo style)Tianjin dialect + same multilingual set
Sunny四川-晴儿Sichuan dialect femaleSichuan dialect + same multilingual set
Eric四川-程川Sichuan dialect maleSichuan dialect + same multilingual set
Rocky粤语-阿强Cantonese maleCantonese + same multilingual set
Kiki粤语-阿清Cantonese femaleCantonese + same multilingual set

Language (input.language)

Optional. Sets the synthesis language (Qwen API field: language_type). Default Auto.
ValueWhen to use
AutoMixed-language text or uncertain language. The model matches pronunciation per segment; accuracy is not guaranteed.
ChineseSingle-language Chinese text — typically better quality than Auto
EnglishSingle-language English text
GermanSingle-language German text
ItalianSingle-language Italian text
PortugueseSingle-language Portuguese text
SpanishSingle-language Spanish text
JapaneseSingle-language Japanese text
KoreanSingle-language Korean text
FrenchSingle-language French text
RussianSingle-language Russian text
For monolingual content, specify the language explicitly instead of Auto for best results.

Authorizations

Authorization
string
header
required

Authorization: Bearer YOUR_API_KEY

Body

application/json
model
enum<string>
default:qwen3-tts-flash
required

Model ID. Use qwen3-tts-flash for this endpoint.

Available options:
qwen3-tts-flash
Example:

"qwen3-tts-flash"

function
enum<string>
required

Task type. Must be audio for text-to-speech.

Available options:
audio
Example:

"audio"

input
object
required
webhook
string<uri>

Optional HTTPS callback URL when the task completes, fails, or is cancelled.

Response

Async task created

data
object
required