https://developer.voicemaker.in/voice/api

Authentication

The VoiceMaker API authenticates request using API keys sent in the HTTP Authorization request header. API keys are sent as bearer tokens (type "bearer").

Your authorization production API key is:

Authorization: Bearer YOUR-API-KEY

Content Type

All requests are JSON-encoded and versioned using the HTTP Content-Type request header.
Your Content-Type header should look like:

Content-Type: application/json;

Error Response

Status: 200 OK

{
    "success": true,
    "path": "https://developer.voicemaker.in/uploads/1605116292576-voicemaker.in-speech.mp3"
}

Status: 400 Bad Request

{
    "success": false,
    "message": "Error converting your text, please check tags or settings in text."
}

Generate Audio

To generate audio, make a POST request to the main API endpoint.

curl https://developer.voicemaker.in/voice/api \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"Engine": "neural", "VoiceId": "ai3-Jony", "LanguageCode": "en-US", "Text": "Welcome to the Air.", "OutputFormat": "mp3", "SampleRate": "48000", "Effect": "default", "MasterSpeed": "0", "MasterVolume": "0", "MasterPitch": "0" }' \
  > '{ "success": true, "path": "https://developer.voicemaker.in/uploads/1605002662512-voicemaker.in-speech.mp3"}'

Please note: Output file will be deleted from our server within a hour

Attributes (*Required all)

Engine
standard, neural

VoiceId
ai2-Katie, ai2-Kathy, ai2-Isabella, ai2-Robert, ai2-Jerry
(Please refer below to get a full list of Available Voices)

LanguageCode
en-US, en-GB, en-AU
(Please refer below to Available Voices)

AccentCode (Optional)
en-US, en-GB, en-AU, da-DK, de-DE, nl-NL, en-IN, en-GB-WLS, fr-FR, fr-CA, es-US
(AccentCode only work with neural and standard AI1 voices. If required other accent language support, please let us know.)

Text
The audio request text. The length of this string is limited to 3000 characters per request. If SSML tags support required then please let us know.

Welcome to the Air, The Future is Here.
Get The Complete Caller Experience.

Inline Tags which you can add in Text (Before implementation, please test the voice)

Hey, <emphasis level='strong'>Everything is cool?</emphasis>
Hey, <emphasis level='moderate'>How are you?</emphasis>
Hey, <emphasis level='reduced'>How is going on ?</emphasis>

Testing 500 ms pause <break time='500ms'/> here.
Testing 2 seconds pause <break time='2s'/> here.

We are testing <prosody rate='slow'> Slow speed.</prosody> here.
We are testing <prosody rate='90%'> Slow speed.</prosody> here.
We are testing <prosody pitch='low'> Lower Pitch.</prosody> here.
We are testing <prosody pitch='-10%'> Lower Pitch.</prosody> here.
We are testing <prosody volume='soft'> Low Volume.</prosody> here.

OutputFormat
mp3, wav
(We suggest to use mp3 in real-time applications. Wav files could take longer time to convert the audio.)

SampleRate
48000, 44100, 24000, 22050, 16000, 8000
(Always use 48000, we automatically choose for the best audio output on all voices.)

Effect
default
breathing, soft, whispered - Only supports standard Engine ai1 voices.
conversational - Only support on neural Engine en-US - ai1-Joanna, ai1-Matthew, ai3-Aria, ai3-Jenny, cmn-CN - ai3-cmn-CN-Xiaoxiao.
news - Only support on neural Engine en-GB - ai1-Amy, en-US - ai3-Jony, ai3-Aria, ai3-Jenny, es-US - ai1-es-US-Lupe

MasterSpeed
0 is the default
-100 to 100

MasterVolume
0 is the default
-20 to 20

MasterPitch
0 is the default
-100 to 100
MasterPitch does not support neural Engine ai1 voices.

Get List of All Voices

To get list of all voices, make a POST request to voice list API endpoint.

curl https://developer.voicemaker.in/voice/list \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"language": "en-US" }' \
  > '{ "success": true, "data": { "voices_list": [ { "Engine": "neural", "VoiceId": "ai1-Joanna", "VoiceGender": "Female", "VoiceWebname": "Joanna", "Country": "US", "Language": "en-US", "LanguageName": "English, US" }, { "Engine": "neural", "VoiceId": "ai1-Kendra", "VoiceGender": "Female", "VoiceWebname": "Kendra", "Country": "US", "Language": "en-US", "LanguageName": "English, US" } ] } }'

For the voice list API, we do not collect request data.

Available Voices on API