Skip to main content

๐ŸŽ™๏ธ Supernal TTS

High-performance Text-to-Speech API with multi-provider support, intelligent caching, and real-time audio generation.

:::tip Development Status Supernal TTS is currently in active development. While functional, some features may be incomplete or subject to change. We appreciate your patience as we work to deliver the best TTS experience possible! :::

โœจ Featuresโ€‹

  • ๐Ÿš€ Multi-Provider Support - OpenAI, Cartesia, Azure, and Mock providers
  • โšก Fast Performance - High-performance audio generation with intelligent caching
  • ๐Ÿ’พ Intelligent Caching - Automatic content-based caching
  • ๐Ÿ”’ Production Ready - Authentication, rate limiting, security headers
  • ๐ŸŽฏ Easy Integration - REST API, JavaScript SDK, and web widget
  • ๐Ÿ’ฐ Cost Optimization - Provider comparison and cost estimation

๐Ÿš€ Add Voice to Your Website (Choose Your Way)โ€‹

Like Google Analytics - Zero config!

<script src="https://unpkg.com/@supernal/tts-widget@1/dist/widget.js"></script>
<script>
window.SupernalTTS.init({ apiKey: 'YOUR_KEY' });
</script>

<div class="supernal-tts-widget" data-text="Content">
Content
</div>

โœ… No bundler โœ… No npm โœ… Works everywhere

๐Ÿ“ฆ NPM Packageโ€‹

For build tool users

npm install @supernal/tts-widget
import { SupernalTTS } from '@supernal/tts-widget';
SupernalTTS.init({ apiKey: 'YOUR_KEY' });

โœ… Version locked โœ… TypeScript support โœ… Works offline

โš›๏ธ React Componentโ€‹

For React purists

import { TTSInitializer } from '@supernal/tts-widget/react';

<TTSInitializer apiKey="YOUR_KEY" />

โœ… Props-based config โœ… Type-safe โœ… React-friendly

โ†’ Complete Installation Guide โ†


๐Ÿ”‘ Get Your Free API Keyโ€‹

  1. Visit www.tts.supernal.ai
  2. Sign up (free!)
  3. Copy your API key
  4. Start adding voice to your site!

๐Ÿ› ๏ธ For Developers: Self-Hosted APIโ€‹

1. Install and Runโ€‹

# Clone the repository
git clone https://github.com/supernalintelligence/supernal-nova.git
cd supernal-nova/families/supernal-tts

# Install dependencies
npm install

# Start the server (uses mock provider by default)
npm run dev

The API will be available at http://localhost:3030

2. Test with Mock Providerโ€‹

curl -X POST https://tts.supernal.ai/api/v1/generate \
-H "Content-Type: application/json" \
-d '{
"text": "Hello world!",
"options": {
"provider": "mock"
}
}'

3. Add Real Providersโ€‹

Create a .env file:

# OpenAI (recommended for quality)
OPENAI_API_KEY=sk-...

# Cartesia (recommended for speed)
CARTESIA_API_KEY=...

# Azure (recommended for budget)
AZURE_API_KEY=...
AZURE_REGION=eastus

4. Generate Real Audioโ€‹

curl -X POST https://tts.supernal.ai/api/v1/generate \
-H "Content-Type: application/json" \
-d '{
"text": "Welcome to Supernal TTS!",
"options": {
"provider": "openai",
"voice": "fable"
}
}'

๐ŸŽฏ Provider Comparisonโ€‹

ProviderPerformanceCost/1M charsBest ForKey Feature
mockDevelopment$0TestingNo API key needed
openaiHigh$15-30Quality6 premium voices
cartesiaFast~$24Real-timeEmotion control
azureGood$0-16Budget500K free tier

๐Ÿ“š Next Stepsโ€‹

๐ŸŽฎ Interactive Demoโ€‹

Try the live demo:

# Or run comparison tests locally
./demo-scripts/compare-all-providers.sh "Test message"

๐Ÿ’ก Use Casesโ€‹

  • Blog Audio - Convert articles to audio
  • E-learning - Course narration
  • Accessibility - Screen reader enhancement
  • Chatbots - Voice responses
  • Podcasts - Automated narration
  • Games - Character voices

๐Ÿค Supportโ€‹


๐ŸŽง Try It Nowโ€‹

:::info Development Preview This TTS widget is currently under active development. Features may not work perfectly and are subject to change. We're working hard to improve the experience! :::

Welcome to Supernal TTS! This is a live demo of our text-to-speech widget using eSpeak (our free, open-source provider). Click the button below to hear this text spoken aloud with real speech synthesis.


Ready to get started? Check out the API Reference or jump to the Quick Reference for common patterns.