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"}'

By default, Output file will be automatically removed from our server within one hour.
However, you have the option to configure it (FileStore) to remain for up to ten days (240 hours).

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 10,000 characters per request, the requests above 3,000 characters may take a little longer to generate a speech. 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.)

ResponseType
file, stream
(By default, we choose file, which results audio in a downlodable url file. stream will results audio in AudioBuffer format, which can be saved to a buffer, or saved to a file. stream will save your addional HTTP request for downloading audio file via URL.)

FileStore
1 is the default
1 to 240
(You can specify the duration for retaining your converted output audio file in hours. The maximum limit allowed is up to 240 hours, which is equivalent to 10 days. This parameter is not supported on ResponseType: stream.)

CustomFileName
yourfilename
(You can able to custom-named Output audio file as specified. This parameter is not supported on ResponseType: stream.)

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