跳转到主要内容
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"
  }
}

​
音色参数（input.voice）

在 input.voice 中传入音色预设名称。下表为 Qwen TTS 音色列表；qwen3-tts-flash 支持表中绝大部分音色（部分方言音色另支持 qwen-tts-latest 等模型，以平台模型页为准）。
voice音色名描述支持语种
Cherry芊悦阳光积极、亲切自然小姐姐（女性）中文（普通话）、英语、法语、德语、俄语、意大利语、西班牙语、葡萄牙语、日语、韩语
Serena苏瑶温柔小姐姐（女性）同上
Ethan晨煦标准普通话，带部分北方口音。阳光、温暖、活力、朝气（男性）同上
Chelsie千雪二次元虚拟女友（女性）同上
Momo茉兔撒娇搞怪，逗你开心（女性）同上
Vivian十三拽拽的、可爱的小暴躁（女性）同上
Moon月白率性帅气的月白（男性）同上
Maia四月知性与温柔的碰撞（女性）同上
Kai凯耳朵的一场 SPA（男性）同上
Nofish不吃鱼不会翘舌音的设计师（男性）同上
Bella萌宝喝酒不打醉拳的小萝莉（女性）同上
Jennifer詹妮弗品牌级、电影质感般美语女声（女性）同上
Ryan甜茶节奏拉满，戏感炸裂，真实与张力共舞（男性）同上
Katerina卡捷琳娜御姐音色，韵律回味十足（女性）同上
Aiden艾登精通厨艺的美语大男孩（男性）同上
Eldric Sage沧明子沉稳睿智的老者，沧桑如松却心明如镜（男性）同上
Mia乖小妹温顺如春水，乖巧如初雪（女性）同上
Mochi沙小弥聪明伶俐的小大人，童真未泯却早慧如禅（男性）同上
Bellona燕铮莺声音洪亮，吐字清晰，人物鲜活（女性）同上
Vincent田叔独特的沙哑烟嗓（男性）同上
Bunny萌小姬「萌属性」爆棚的小萝莉（女性）同上
Neil阿闻专业新闻主持人（男性）同上
Elias墨讲师学科严谨、叙事清晰（女性）同上
Arthur徐大爷质朴嗓音，讲满村奇闻异事（男性）同上
Nini邻家妹妹又软又黏的嗓音（女性）同上
Seren小婉温和舒缓，助眠（女性）同上
Pip顽屁小孩调皮捣蛋却充满童真（男性）同上
Stella少女阿月甜到发腻的迷糊少女音（女性）同上
Bodega博德加热情的西班牙大叔（男性）同上
Sonrisa索尼莎热情开朗的拉美大姐（女性）同上
Alek阿列克战斗民族的冷与暖（男性）同上
Dolce多尔切慵懒的意大利大叔（男性）同上
Sohee素熙温柔开朗的韩国欧尼（女性）同上
Ono Anna小野杏鬼灵精怪的青梅竹马（女性）同上
Lenn莱恩理性底色，叛逆藏在细节里（男性）同上
Emilien埃米尔安浪漫的法国大哥哥（男性）同上
Andre安德雷声音磁性，自然舒服、沉稳男生（男性）同上
Radio Gol拉迪奥·戈尔足球诗人，激情解说（男性）同上
Jada上海-阿珍风风火火的沪上阿姐（女性）中文（上海话）及多语种
Dylan北京-晓东北京胡同里长大的少年（男性）中文（北京话）及多语种
Li南京-老李耐心的瑜伽老师（男性）中文（南京话）及多语种
Marcus陕西-秦川面宽话短，心实声沉（男性）中文（陕西话）及多语种
Roy闽南-阿杰诙谐直爽的台湾哥仔（男性）中文（闽南语）及多语种
Peter天津-李彼得天津相声，专业捧哏（男性）中文（天津话）及多语种
Sunny四川-晴儿甜到你心里的川妹子（女性）中文（四川话）及多语种
Eric四川-程川跳脱市井的成都男子（男性）中文（四川话）及多语种
Rocky粤语-阿强幽默风趣的阿强，在线陪聊（男性）中文（粤语）及多语种
Kiki粤语-阿清甜美的港妹闺蜜（女性）中文（粤语）及多语种

​
语种参数（input.language）

可选。指定合成音频的语种（对应 Qwen 文档字段 language_type）。默认 Auto。
取值说明
Auto适用于文本包含多种语言或语种不确定的场景。模型自动为不同语言片段匹配发音，但无法保证完全精准。
Chinese单一中文文本，合成质量通常优于 Auto
English单一英语文本
German单一德语文本
Italian单一意大利语文本
Portuguese单一葡萄牙语文本
Spanish单一西班牙语文本
Japanese单一日语文本
Korean单一韩语文本
French单一法语文本
Russian单一俄语文本
文本为单一语种时，建议指定具体语种而非 Auto，以获得更好效果。

授权

​
Authorization
string
header
必填

Authorization: Bearer YOUR_API_KEY

请求体

application/json
​
model
enum<string>
默认值:qwen3-tts-flash
必填

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

可用选项:
qwen3-tts-flash
示例:

"qwen3-tts-flash"

​
function
enum<string>
必填

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

可用选项:
audio
示例:

"audio"

​
input
object
必填
​
webhook
string<uri>

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

响应

Async task created

​
data
object
必填