curl --request POST \
  --url https://gateway.widebot.net/api/v3/AQL/TextToSpeech \
  --header 'Content-Type: application/json' \
  --header 'x-bot: <api-key>' \
  --header 'x-user-auth: <api-key>' \
  --data '
{
  "TextMessage": "مرحباً بكم في منصة وايد بوت للذكاء الاصطناعي",
  "LanguageCode": "ar-sa",
  "Speaker": "Rawy",
  "ModelType": "v1"
}
'

{
  "StatusCode": 200,
  "Response": {
    "AudioData": "<string>",
    "Metadata": {
      "Format": "Wav",
      "SampleRate": 24000,
      "Channels": 1
    },
    "RequestId": "req_6a9d7d739b18"
  },
  "Consumption": "18/15000"
}

Convert Text to Speech

Convert text to high-quality speech with natural Arabic voices and multiple language support.

Arabic Excellence:

Natural pronunciation for Arabic dialects
Regional voice variations
Cultural context understanding
Proper Arabic phonetics

Available Speakers:

Arabic Male: Hesham (recommended for MSA/Egyptian), Rawy (recommended for Saudi), Mohamed, Adel, Hytham
Arabic Female: Hala (Saudi), Lina, Mona, Alice, Esraa
English: Marcos Rudaski, Claribel Dervla

Consumption: Based on character count in input text

Note: Example requests/responses shown here are illustrative. When using the live “Try it” tool, you may see two responses: an HTTP status preview and the API’s JSON body.

POST

/

api

/

v3

/

AQL

/

TextToSpeech

curl --request POST \
  --url https://gateway.widebot.net/api/v3/AQL/TextToSpeech \
  --header 'Content-Type: application/json' \
  --header 'x-bot: <api-key>' \
  --header 'x-user-auth: <api-key>' \
  --data '
{
  "TextMessage": "مرحباً بكم في منصة وايد بوت للذكاء الاصطناعي",
  "LanguageCode": "ar-sa",
  "Speaker": "Rawy",
  "ModelType": "v1"
}
'

{
  "StatusCode": 200,
  "Response": {
    "AudioData": "<string>",
    "Metadata": {
      "Format": "Wav",
      "SampleRate": 24000,
      "Channels": 1
    },
    "RequestId": "req_6a9d7d739b18"
  },
  "Consumption": "18/15000"
}

Authorizations

x-user-auth

string

header

required

Your API key from account settings

x-bot

string

header

required

Your bot ID from account settings

Body

application/json

TextMessage

string

required

Text to convert to speech

Example:

"وش علومك اليوم؟"

LanguageCode

string

required

Language code for speech synthesis

Example:

"ar-sa"

Speaker

string

required

Voice to use for speech generation

Example:

"Rawy"

ModelType

string

required

Required. Voice model version. One of: v1, v1-fast, v2, v3, v4, or eval-*.

Example:

"v1"

temperature

number<float>

Controls variation in speech generation

Required range: 0 <= x <= 1

Example:

0.5

output_sr

integer

Output sample rate in Hz

Example:

24000

session_id

string

Optional session identifier

Example:

"example-session-001"

Response

200 - application/json

Text to speech conversion successful

StatusCode

integer

Example:

200

Response

object

Show child attributes

Consumption

string

Character usage tracking

Example:

"18/15000"