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": "inworld-tts-1.5-mini",
  "function": "audio",
  "input": {
    "prompt": "Welcome to ShuYou AI documentation.",
    "voice": "Craig (en)"
  },
  "webhook": "https://api.shuyou.ai/backend/api/callback"
}
'
{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

​
Prompt (input.prompt)

Required. Text to synthesize. Maximum 2,000 characters.

​
Voice presets (input.voice)

Optional. Default Craig (en). Pass the voice ID exactly as listed (language tag in parentheses).
#voice
1Loretta (en)
2Darlene (en)
3Marlene (en)
4Hank (en)
5Evelyn (en)
6Celeste (en)
7Pippa (en)
8Tessa (en)
9Liam (en)
10Callum (en)
11Hamish (en)
12Abby (en)
13Graham (en)
14Rupert (en)
15Mortimer (en)
16Snik (en)
17Anjali (en)
18Saanvi (en)
19Arjun (en)
20Claire (en)
21Oliver (en)
22Simon (en)
23Elliot (en)
24James (en)
25Serena (en)
26Gareth (en)
27Vinny (en)
28Lauren (en)
29Jessica (en)
30Ethan (en)
31Tyler (en)
32Jason (en)
33Chloe (en)
34Veronica (en)
35Victoria (en)
36Miranda (en)
37Sebastian (en)
38Victor (en)
39Malcolm (en)
40Kayla (en)
41Nate (en)
42Jake (en)
43Brian (en)
44Amina (en)
45Kelsey (en)
46Derek (en)
47Grant (en)
48Evan (en)
49Alex (en)
50Ashley (en)
51Craig (en)
52Deborah (en)
53Dennis (en)
54Edward (en)
55Elizabeth (en)
56Hades (en)
57Julia (en)
58Pixie (en)
59Mark (en)
60Olivia (en)
61Priya (en)
62Ronald (en)
63Sarah (en)
64Shaun (en)
65Theodore (en)
66Timothy (en)
67Wendy (en)
68Dominus (en)
69Hana (en)
70Clive (en)
71Carter (en)
72Blake (en)
73Luna (en)
74Yichen (zh)
75Xiaoyin (zh)
76Xinyi (zh)
77Jing (zh)
78Erik (nl)
79Katrien (nl)
80Lennart (nl)
81Lore (nl)
82Alain (fr)
83Hélène (fr)
84Mathieu (fr)
85Étienne (fr)
86Johanna (de)
87Josef (de)
88Gianni (it)
89Orietta (it)
90Asuka (ja)
91Satoshi (ja)
92Hyunwoo (ko)
93Minji (ko)
94Seojun (ko)
95Yoona (ko)
96Szymon (pl)
97Wojciech (pl)
98Heitor (pt)
99Maitê (pt)
100Diego (es)
101Lupita (es)
102Miguel (es)
103Rafael (es)
104Svetlana (ru)
105Elena (ru)
106Dmitry (ru)
107Nikolai (ru)
108Riya (hi)
109Manoj (hi)
110Yael (he)
111Oren (he)
112Nour (ar)
113Omar (ar)

Authorizations

​
Authorization
string
header
required

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
default:inworld-tts-1.5-mini
required

Model ID. Use inworld-tts-1.5-mini for this endpoint.

Available options:
inworld-tts-1.5-mini
Example:

"inworld-tts-1.5-mini"

​
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