11x cheaper than Eleven Labs
Stream audio in 300ms
Request up to 10-hour audio
Includes per-word timestamps
|
Number of Characters
one time
|
1M
|
|
Audio Duration
Estimated
|
~22 hours
|
|
Free
|
$0
|
|
Additional Usage
|
—
|
# Endpoint: /stream
# - Convert up to 1,000 characters ASAP
# - Synchronous, instant response (0.3s)
# - Streams back raw audio data (no timestamps)
import requests
response = requests.post(
'https://api.v8.unrealspeech.com/stream',
headers = {
'Authorization' : 'Bearer YOUR_API_KEY'
},
json = {
'Text': '''<YOUR_TEXT>''', # Up to 1,000 characters
'VoiceId': '<VOICE_ID>', # af, af_bella, af_sarah, am_adam, am_michael, bf_emma, bf_isabella, bm_george, bm_lewis, af_nicole, af_sky
'Bitrate': '192k', # 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)# Endpoint: /streamWithTimestamps
# - Convert text with real-time word-level timestamps
# - Streams audio with precise word timing information
# - Perfect for word-by-word highlighting
import websocket
import json
audio_chunks = []
timestamps = []
def on_message(ws, message):
try:
data = json.loads(message)
if data.get("type") == "progress" and "message" in data:
msg_val = data["message"]
if isinstance(msg_val, list):
timestamps.extend(msg_val)
elif data.get("type") == "complete":
ws.close()
except Exception:
# Assume binary audio data
audio_chunks.append(message)
def on_open(ws):
config = {
"Text": "<YOUR_TEXT>",
"VoiceId": "<VOICE_ID>",
"Model": "kokoro",
"Codec": "libmp3lame",
"SampleRate": 24000,
"Speed": 0,
"Bitrate": "192k",
"Pitch": 1.0,
"TimestampType": "word"
}
ws.send(json.dumps(config))
ws = websocket.WebSocketApp(
"wss://api.v8.unrealspeech.com/streamWithTimestamps",
on_open=on_open,
on_message=on_message
)
ws.run_forever()// Short endpoint: /stream
// - Up to 1,000 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 1,000 characters
'VoiceId': '<VOICE_ID>', // Scarlett, Dan, Liv, Will, Amy
'Bitrate': '192k', // 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.v8.unrealspeech.com/stream',
headers: headers,
data: data,
responseType: 'stream'
}).then(function (response) {
response.data.pipe(fs.createWriteStream('audio.mp3'))
});
// Short endpoint: /stream
// - Up to 1,000 characters
// - Synchronous, instant response (0.3s+)
// - Streams back raw audio data
import React from "react";
import { View, Button, ActivityIndicator } from "react-native";
import { useUnrealSpeech, blobToDataURI } from "react-native-unrealspeech";
import { Audio } from "expo-av";
export default function App() {
const { stream, requestState } = useUnrealSpeech("YOUR_API_KEY");
const play = async (response: any) => {
try {
if (!response.ok) {
throw new Error("Network response was not ok");
}
const blobData = await response.blob();
const blob = new Blob([blobData], { type: "audio/mp3" });
const uri = await blobToDataURI(blob);
const { sound } = await Audio.Sound.createAsync({ uri }, {});
console.log(uri);
await sound.playAsync();
} catch (error) {
console.error("Error occurred while playing sound:", error);
}
};
const handleSpeak = async () => {
try {
const response = await stream(
"<YOUR_TEXT>", // Up to 1,000 characters
"<VOICE_ID>", // Scarlett, Dan, Liv, Will, Amy
"192k", // 320k, 256k, 192k, ...
0, // Speed: -1.0 to 1.0
1, // Pitch: 0.5 to 1.5
"libmp3lame" // Codec: libmp3lame or pcm_mulaw
);
play(response);
} catch (error) {
console.error("Error occurred while handling speak:", error);
}
};
return (
<View style={{ flex: 1, justifyContent: "center" }}>
{requestState === "loading" ? (
<ActivityIndicator />
) : (
<Button title="Speak" onPress={handleSpeak} />
)}
</View>
);
}
// Medium endpoint: /speech
// - Up to 3,000 characters
// - Synchronous, takes ~1s per 700 chars
// - Returns MP3 and JSON timestamp URLs
import React from "react";
import { StatusBar } from "expo-status-bar";
import { StyleSheet, Button, View, ActivityIndicator } from "react-native";
import { useUnrealSpeech } from "react-native-unrealspeech";
export default function App() {
const { speech, requestState } = useUnrealSpeech("YOUR_API_KEY");
const handleSpeak = async () => {
const mySpeech = await speech(
"<YOUR_TEXT>", // Up to 3,000 characters
"<VOICE_ID>", // Scarlett, Dan, Liv, Will, Amy
"192k", // 320k, 256k, 192k, ...
"sentence" // word or sentence
);
console.log(mySpeech);
};
return (
<View style={styles.container}>
<StatusBar style="auto" />
{requestState === "loading" ? (
<ActivityIndicator />
) : (
<Button title="Speak" onPress={handleSpeak} />
)}
</View>
);
}
const styles = StyleSheet.create(
{
container: {
flex: 1,
backgroundColor: "#fff",
alignItems: "center",
justifyContent: "center"
}
}
);# Short endpoint: /stream
# - Up to 1,000 characters
# - Synchronous, instant response (0.3s+)
# - Streams back raw audio data
curl -X POST "https://api.v8.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
