Skip to main content
POST
/
v1
/
generation
/
text-to-audio
Submit Text-to-Speech Task
curl --request POST \
  --url https://api.weryai.com/v1/generation/text-to-audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Hello, welcome to WeryAI!",
  "voice_id": 85,
  "speed": "1.0",
  "vol": "4.0",
  "webhook_url": "https://your-server.com/webhook"
}
'
{
  "status": 0,
  "desc": "success",
  "message": "success",
  "data": {
    "task_id": "task_abc123",
    "task_status": "waiting"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.weryai.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate using Bearer token. Get your API Key from the WeryAI Console.

Example: Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Body

application/json
​
text
string
required

Input text to synthesize, maximum 500 characters

Maximum string length: 500
Example:

"Hello, welcome to WeryAI!"

​
voice_id
integer<int64>
required

Voice ID specifying the voice style to use. See the Voice Reference appendix below for all available system voices.

Voice Reference Appendix

English Voices

IDVoice NameGenderPreview
85Captivating FemaleFEMALE▶ Preview
84Playful GirlFEMALE▶ Preview
83Lovely GirlFEMALE▶ Preview
82Cheerful ChloeFEMALE▶ Preview
81Wise LadyFEMALE▶ Preview
75Southern DudeMALE▶ Preview
74Lucky RobotMALE▶ Preview
73Angry PirateMALE▶ Preview
72Friendly GiantMALE▶ Preview
71Man With Deep VoiceMALE▶ Preview

Chinese Voices

IDVoice NameGenderPreview
80Arrogant MissFEMALE▶ Preview
79Kind-hearted AntieFEMALE▶ Preview
78Gentle SeniorFEMALE▶ Preview
77Intellectual GirlFEMALE▶ Preview
76News AnchorFEMALE▶ Preview
70Stubborn FriendMALE▶ Preview
69Reliable ExecutiveMALE▶ Preview
68Lyrical VoiceMALE▶ Preview
67Refreshing Young ManMALE▶ Preview
66Pure-hearted BoyMALE▶ Preview
Example:

85

​
speed
string
default:1.0

Speech speed. Higher values produce faster speech. Range: [0.5, 2.0]. Default: 1.0

Example:

"1.0"

​
vol
string
default:4.0

Volume level. Higher values produce louder audio. Range: (0, 10.0]. Default: 4.0

Example:

"4.0"

​
caller_id
integer<int64>

Caller ID (for business association)

​
trace_id
string

Custom trace ID passed by the caller for request tracing

Example:

"my-trace-001"

​
webhook_url
string<uri>

Callback URL where results will be sent when task completes

Example:

"https://your-server.com/webhook"

Response

Task submitted successfully

​
status
integer

Business status code (0 indicates success)

Example:

0

​
desc
string

Status description

Example:

"success"

​
message
string

Multi-language message

Example:

"success"

​
data
object