Text to Speech
Inworld Realtime TTS 2.0
Next-generation ultra-fast neural text-to-speech engine. Features natural-language emotional steering, non-verbal cues (laughter, sighs), and multilingual voice synthesis in under 1 second.
API Endpoint
POST https://lumozai.com/api/v4/run
Use this endpoint to run the model with your parameters. Authentication is required using your API key.
Sample Code (PHP cURL)
<?php
// API endpoint URL
$apiUrl = 'https://lumozai.com/api/v4/run';
// Your API key
$apiKey = 'YOUR_API_KEY';
// Model parameters
$params = [
'model_id' => 'realtime-tts-2',
'text' => 'Welcome to Lumoz AI studio. Experience ultra-fast, expressive voice synthesis with natural human emotion.',
'voice_id' => 'Ashley',
'language' => 'auto',
'audio_format' => 'mp3',
'speaking_rate' => 0,
'sample_rate' => 48000,
];
// Initialize cURL session
$curl = curl_init();
// Set cURL options
curl_setopt_array($curl, [
CURLOPT_URL => $apiUrl,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $params,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Authorization: Bearer ' . $apiKey
]
]);
// Execute the request
$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
// Check for errors
if (curl_errno($curl)) {
echo 'cURL Error: ' . curl_error($curl);
} else {
// Process the response
$result = json_decode($response, true);
if ($httpCode == 200 && isset($result['success']) && $result['success']) {
// Handle successful response
echo "Model output: ";
print_r($result['data']['output']);
} else {
// Handle error response
echo "Error: " . ($result['message'] ?? 'Unknown error');
}
}
// Close cURL session
curl_close($curl);
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | Required | The ID of the model to run (realtime-tts-2) |
| api_key | string | Required | Your API key for authentication (sent via Bearer token in the Authorization header) |
| text | string | Required | The text to convert to speech (up to 2,000 characters). Supports emotional steering tags like [say excitedly], [whisper], non-verbal cues [laugh], [sigh], and SSML pause breaks <break time="1s" />. |
| voice_id | string | Optional | Preset voice persona or custom voice identifier. |
| language | string | Optional | Language detection or explicit specification. |
| audio_format | string | Optional | Output audio format. |
| speaking_rate | number | Optional | Speaking speed multiplier. Set to 0 for natural default pace (1.0x). |
| sample_rate | string | Optional | Audio sample rate in Hz. |
Response Format
{
"success": true,
"data": {
"output": "This is the text output from the model based on your input parameters."
}
}
Model Pricing
Pay only for what you run. Charges are deducted directly from your account balance with zero recurring commitments.
Rate per generation
$
0.005
/ generation
$5.00 per 1,000 generations
Cost Estimator
1,000 generations
Estimated Total
$5.00
Automatic instant refund if any run fails • Credits valid for 1 year