Skip to main content
POST
Submit Text-to-Speech Task

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

Chinese Voices

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