Code Samples

Get started quickly with our simple text-to-speech API.

Short
Long


                    


# Short endpoint: /stream
# - Up to 500 characters
# - Synchronous, instant response (0.3s+)
# - Streams back raw audio data

import requests

response = requests.post(
  'https://api.v6.unrealspeech.com/stream',
  headers = {
    'Authorization' : 'Bearer YOUR_API_KEY'
  },
  json = {
    'Text': '''<YOUR_TEXT>''', # Up to 500 characters
    'VoiceId': '<VOICE_ID>', # Dan, Will, Scarlett, Liv, Amy
    'Bitrate': '128k', # 320k, 256k, 192k, ...
    'Speed': '0', # -1.0 to 1.0
    'Pitch': '1', # -0.5 to 1.5
    'Codec': 'libmp3lame', # libmp3lame or pcm_mulaw
  }
)

with open('audio.mp3', 'wb') as f:
    f.write(response.content)



# Long endpoint: /synthesisTasks
# - Up to 500,000 characters
# - Asynchronous, takes ~1s per 800 chars
# - Returns a TaskId (use to check status)

import requests

response = requests.post(
  'https://api.v6.unrealspeech.com/synthesisTasks',
  headers = {
    'Authorization' : 'Bearer YOUR_API_KEY'
  },
  json = {
    'Text': '''<YOUR_TEXT>''', # Up to 500,000 characters
    'VoiceId': '<VOICE_ID>', # Dan, Will, Scarlett, Liv, Amy
    'Bitrate': '128k', # 320k, 256k, 192k, ...
    'Speed': '0', # -1.0 to 1.0
    'Pitch': '1', # -0.5 to 1.5
    'TimestampType': 'sentence', # word or sentence
   #'CallbackUrl': '<URL>', # pinged when ready
  }
)

print(response.json())

Sample Response

{
  'SynthesisTask': {
    'CreationTime': '2023-09-01T15:05:22.15Z',
    'OutputUri': 'https://unreal-tts-live-demo.s3-us-west-1.amazonaws.com/d8ef514d.mp3',
    'RequestCharacters': 14,
    'TaskId': 'd8ef514d',
    'TaskStatus': 'scheduled',
    'TimestampsUri': 'https://unreal-tts-live-demo.s3-us-west-1.amazonaws.com/d8ef514d.json',
    'VoiceId': 'Scarlett'
  }
}
Check Task Status
Make a GET request with TaskId in the URL to check the status.

import requests

response = requests.get(
  'https://api.v6.unrealspeech.com/synthesisTasks/d8ef514d',
  headers = {
    'Authorization' : 'Bearer YOUR_API_KEY'
  },
  json = {}
)

print(response.json())


// Short endpoint: /stream
// - Up to 500 characters
// - Synchronous, instant response (0.3s+)
// - Streams back raw audio data

const axios = require('axios');
const fs = require('fs');

const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
};

const data = {
    'Text': '<YOUR_TEXT>', // Up to 500 characters
    'VoiceId': '<VOICE_ID>', // Dan, Will, Scarlett, Liv, Amy
    'Bitrate': '128k', // 320k, 256k, 192k, ...
    'Speed': '0', // -1.0 to 1.0
    'Pitch': '1', // -0.5 to 1.5
    'Codec': 'libmp3lame', // libmp3lame or pcm_mulaw
};

axios({
    method: 'post',
    url: 'https://api.v6.unrealspeech.com/stream',
    headers: headers,
    data: data,
    responseType: 'stream'
}).then(function (response) {
    response.data.pipe(fs.createWriteStream('audio.mp3'))
});




// Long endpoint: /synthesisTasks
// - Up to 500,000 characters
// - Asynchronous, takes ~1s per 800 chars
// - Returns a TaskId (use to check status)

const axios = require('axios');

const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
};

const data = {
    'Text': '<YOUR_TEXT>', // Up to 500,000 characters
    'VoiceId': '<VOICE_ID>', // Dan, Will, Scarlett, Liv, Amy
    'Bitrate': '128k', // 320k, 256k, 192k, ...
    'Speed': '0', // -1.0 to 1.0
    'Pitch': '1', // -0.5 to 1.5
    'TimestampType': 'sentence', // word or sentence
  //'CallbackUrl': '<URL>', // pinged when ready
};

axios({
    method: 'post',
    url: 'https://api.v6.unrealspeech.com/synthesisTasks',
    headers: headers,
    data: data,
}).then(function (response) {
    console.log(JSON.stringify(response.data));
});


Sample Response

{
  'SynthesisTask': {
    'CreationTime': '2023-09-01T15:05:22.15Z',
    'OutputUri': 'https://unreal-tts-live-demo.s3-us-west-1.amazonaws.com/d8ef514d.mp3',
    'RequestCharacters': 14,
    'TaskId': 'd8ef514d',
    'TaskStatus': 'scheduled',
    'TimestampsUri': 'https://unreal-tts-live-demo.s3-us-west-1.amazonaws.com/d8ef514d.json',
    'VoiceId': 'Scarlett'
  }
}
Check Task Status
Make a GET request with TaskId in the URL to check the status.

const axios = require('axios');

const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
};

axios({
    method: 'get',
    url: 'https://api.v6.unrealspeech.com/synthesisTasks/d8ef514d',
    headers: headers,
}).then(function (response) {
    console.log(JSON.stringify(response.data));
});



# Short endpoint: /stream
# - Up to 500 characters
# - Synchronous, instant response (0.3s+)
# - Streams back raw audio data

curl -X POST "https://api.v6.unrealspeech.com/stream" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_API_KEY" --data '{"Text": "<YOUR_TEXT>", "VoiceId": "<VOICE_ID>", "Bitrate": "128k", "Speed": "0", "Pitch": "1", "Codec": "libmp3lame"}' --output audio.mp3



# Long endpoint: /synthesisTasks
# - Up to 500,000 characters
# - Asynchronous, takes ~1s per 800 chars
# - Returns a TaskId (use to check status)

curl -X POST "https://api.v6.unrealspeech.com/synthesisTasks" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_API_KEY" --data '{"Text": "<YOUR_TEXT>", "VoiceId": "<VOICE_ID>", "Bitrate": "128k", "Speed": "0", "Pitch": "1", "TimestampType": "sentence"}' 

Sample Response

{
  'SynthesisTask': {
    'CreationTime': '2023-09-01T15:05:22.15Z',
    'OutputUri': 'https://unreal-tts-live-demo.s3-us-west-1.amazonaws.com/d8ef514d.mp3',
    'RequestCharacters': 14,
    'TaskId': 'd8ef514d',
    'TaskStatus': 'scheduled',
    'TimestampsUri': 'https://unreal-tts-live-demo.s3-us-west-1.amazonaws.com/d8ef514d.json',
    'VoiceId': 'Scarlett'
  }
}
Check Task Status
Make a GET request with TaskId in the URL to check the status.

curl -X GET "https://api.v6.unrealspeech.com/synthesisTasks/d8ef514d" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_API_KEY" 
	Free	Basic	Plus	Enterprise
Price	$0	$49 a month	$499 a month	Custom
Characters	1M one time	3M per month	62M per month	300M+ per month
Cost per 1M characters	—	$16	$8	Volume Discounts
Audio Duration (estimated)	~22 hours	~67 hours	~1,377 hours	Custom
Slash Text-to-Speech Costs by up to 95%

Live Demo

Compare against Google, Microsoft, and Amazon.

Pricing that Scales with You

Start for free. Stay for volume discounts.

Code Samples

Get started quickly with our simple text-to-speech API.

Ready to dive in?

Unreal Speech Studio

Make studio-quality voice overs for podcasts, videos & more.
