# Waves ## Docs - [Add your Voice](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/add-voice-api.md): Add your voice using the Waves API. - [Authentication](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/authentication.md): Learn how to authenticate requests using API keys. - [Concurrency and Limits](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/concurrency-and-limits.md): Understanding API concurrency limits and rate limiting - [Delete Cloned Voice](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/delete-cloned-voice.md): Delete a cloned voice using the new Waves API. - [Get your cloned Voices](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/get-cloned-voices-api.md): Retrieve your cloned voices. - [Get Voices](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/get-voices-api.md): Get voices supported for a given model using the new Waves API. - [Lightning v2](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/lightning-v2.md): Get speech for given text using the Waves API - [Lightning v2 SSE](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/lightning-v2-stream.md): Stream speech for given text using the Lightning v2 SSE API - [Lightning v2 WebSocket](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/lightning-v2-ws.md): The Lightning v2 WebSocket API provides real-time text-to-speech streaming capabilities with high-quality voice synthesis. This API uses WebSocket to deliver audio chunks as they're generated, enabling low-latency audio playback without waiting for the entire audio file to process. For an end-to-end… - [Lightning v3.1](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/lightning-v3.1.md): Get speech for given text using the Lightning v3.1 model - [Lightning v3.1 SSE](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/lightning-v3.1-stream.md): Stream speech for given text using the Lightning v3.1 SSE API - [Lightning v3.1 WebSocket](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/lightning-v3.1-ws.md): The Lightning v3.1 WebSocket API provides real-time text-to-speech streaming capabilities with natural, expressive voice synthesis. This API uses WebSocket to deliver audio chunks as they're generated, enabling low-latency audio playback without waiting for the entire audio file to process. - [Create Pronunciations Dict](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/pronunciations-dict/create.md): Create pronunciations dicts using the Waves API - [Delete Pronunciations Dict](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/pronunciations-dict/delete.md): Delete pronunciations dicts using the Waves API - [List Pronunciations Dicts](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/pronunciations-dict/list.md): Get pronunciations dicts using the Waves API - [Update Pronunciations Dict](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/pronunciations-dict/update.md): Update pronunciations dicts using the Waves API - [Pulse (Pre-Recorded)](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/pulse-stt.md): Convert speech to text using file upload with the Pulse STT POST API - [Pulse (Realtime)](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/pulse-stt-ws.md): The Pulse STT WebSocket API provides real-time speech-to-text transcription capabilities with streaming audio input. This API uses WebSocket to deliver transcription results as audio is processed, enabling low-latency transcription without waiting for the entire audio file to upload. Perfect for liv… - [WebSocket Support for Text to Speech (TTS) API](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/api-references/websocket.md): Learn about WebSocket support for our Text-to-Speech (TTS) API, how it works, and when to use it. - [TTS Best Practices](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/best-practices/tts-best-practices.md): Text formatting rules for better audio output. Covers numbers, dates, mixed languages, and chunking. - [Voice Cloning Best Practices](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/best-practices/vc-best-practices.md): Guidelines for recording reference audio and achieving high-quality voice clones. - [Announcements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/changelog/announcements.md): New updates and improvements from Smallest AI. - [Client Libraries](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/client-libraries/overview.md): Access Client Libraries by Smallest AI. - [Speech to Text Examples](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/cookbooks/speech-to-text.md): Production-ready code examples for Pulse STT - from real-time streaming to batch transcription. - [Text to Speech Examples](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/cookbooks/text-to-speech.md): Production-ready code examples for Lightning TTS - from basic synthesis to streaming, voice cloning, and full applications. - [Authentication](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/getting-started/authentication.md): Create an API key and authenticate requests to the Smallest AI APIs. - [HTTP vs HTTP Streaming vs Websockets](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/getting-started/http-stream.md): What should you use? - [Introduction](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/getting-started/introduction.md): Speech AI APIs by Smallest AI — generate speech with Lightning TTS and transcribe audio with Pulse STT. - [Models](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/getting-started/models.md): Find detailed description of each model along with their capabilities and supported languages. - [LiveKit](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/integrations/livekit.md): Build LiveKit voice agents using Smallest AI TTS plugin. - [OpenClaw](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/integrations/openclaw.md): Add ultra-fast TTS and STT to your OpenClaw agent with the Smallest AI skill. - [Telephony: Plivo](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/integrations/plivo.md): Learn how to integrate Smallest AI TTS in Plivo for telephony solutions. - [Vercel AI SDK](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/integrations/vercel-ai-sdk.md): Use Smallest AI TTS and STT with the Vercel AI SDK in Next.js and Node.js apps. - [Telephony: Vonage](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/integrations/vonage.md): Learn how to integrate Smallest AI TTS in Vonage for telephony solutions. - [Configuration](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/configuration.md): Advanced configuration options for STT Docker deployments - [Docker Troubleshooting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/docker-troubleshooting.md): Debug common issues and optimize your STT Docker deployment - [Credentials & Access](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/prerequisites/credentials.md): License keys and registry credentials for STT Docker deployment - [Hardware Requirements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/prerequisites/hardware-requirements.md): Hardware specifications for deploying Speech-to-Text with Docker - [Software Requirements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/prerequisites/software-requirements.md): Software and dependencies for deploying Speech-to-Text with Docker - [Verification Checklist](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/prerequisites/verification.md): Verify all prerequisites before deploying STT with Docker - [Quick Start](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/stt/quick-start.md): Deploy Smallest Self-Host Speech-to-Text with Docker Compose in under 15 minutes - [Configuration](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/configuration.md): Advanced configuration options for TTS Docker deployments - [Docker Troubleshooting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/docker-troubleshooting.md): Debug common issues and optimize your TTS Docker deployment - [Credentials & Access](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/prerequisites/credentials.md): License keys and registry credentials for TTS Docker deployment - [Hardware Requirements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/prerequisites/hardware-requirements.md): Hardware specifications for deploying Text-to-Speech with Docker - [Software Requirements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/prerequisites/software-requirements.md): Software and dependencies for deploying Text-to-Speech with Docker - [Verification Checklist](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/prerequisites/verification.md): Verify all prerequisites before deploying TTS with Docker - [Quick Start](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/docker/tts/quick-start.md): Deploy Smallest Self-Host Text-to-Speech with Docker Compose in under 15 minutes - [Architecture Overview](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/getting-started/architecture.md): Understanding the components and architecture of Smallest Self-Host deployments - [Introduction](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/getting-started/introduction.md): Deploy high-performance speech-to-text and text-to-speech models in your own infrastructure - [Prerequisites](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/getting-started/prerequisites.md): What you need before deploying Smallest Self-Host - [Why Self-Host?](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/getting-started/why-self-host.md): Understand when self-hosting our models makes sense for your organization - [Cluster Autoscaler](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/autoscaling/cluster-autoscaler.md): Automatically scale EKS cluster nodes based on pod resource requirements - [Grafana Dashboards](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/autoscaling/grafana-dashboards.md): Visualize metrics, autoscaling behavior, and system performance - [HPA Configuration](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/autoscaling/hpa-configuration.md): Configure Horizontal Pod Autoscaling based on custom metrics - [Metrics Setup](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/autoscaling/metrics-setup.md): Configure Prometheus, ServiceMonitor, and custom metrics collection for Lightning ASR - [AWS EKS Setup](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/aws/eks-setup.md): Create and configure an EKS cluster for Smallest Self-Host with GPU support - [GPU Nodes Configuration](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/aws/gpu-nodes.md): Advanced GPU node setup and optimization for AWS EKS - [IAM & IRSA](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/aws/iam-irsa.md): Configure IAM Roles for Service Accounts in EKS - [Kubernetes Troubleshooting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/k8s-troubleshooting.md): Debug common issues in Kubernetes deployments - [Credentials & Access](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/prerequisites/credentials.md): License keys and registry credentials for Kubernetes STT deployment - [Hardware Requirements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/prerequisites/hardware-requirements.md): Cluster and hardware specifications for Kubernetes STT deployment - [Software Requirements](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/prerequisites/software-requirements.md): Tools and software for Kubernetes STT deployment - [Verification Checklist](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/prerequisites/verification.md): Verify all prerequisites before deploying STT on Kubernetes - [Quick Start](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/quick-start.md): Deploy Smallest Self-Host on Kubernetes with Helm - [EFS Configuration](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/storage/efs-configuration.md): Set up Amazon EFS for shared storage in AWS EKS - [Model Storage](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/storage/model-storage.md): Optimize model storage and caching strategies for Lightning ASR - [Redis Persistence](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/kubernetes/storage/redis-persistence.md): Configure Redis data persistence and high availability - [Common Issues](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/troubleshooting/common-issues.md): Quick solutions to frequently encountered problems - [Debugging Guide](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/troubleshooting/debugging-guide.md): Advanced debugging techniques for Smallest Self-Host - [Logs Analysis](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/on-prem/troubleshooting/logs-analysis.md): Interpret logs and error messages from Smallest Self-Host - [Evaluation Walkthrough](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/benchmarks/evaluation-walkthrough.md): Step-by-step guide to evaluate Pulse STT accuracy and performance - [Metrics Overview](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/benchmarks/metrics-overview.md): Key Pulse STT metrics for quality and latency. - [Performance](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/benchmarks/performance.md): Latency, accuracy, and throughput benchmarks for Pulse STT - [Age & gender detection](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/age-and-gender-detection.md): Predict demographic attributes alongside every transcription - [Speaker diarization](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/diarization.md): Label each word and utterance with turn-by-turn speaker IDs - [Emotion detection](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/emotion-detection.md): Capture per-emotion confidence scores from Pulse STT responses - [Full Transcript](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/full-transcript.md): Get cumulative transcript from real-time WebSocket API - [Inverse Text Normalization (ITN)](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/inverse-text-normalization.md): Convert spoken-form transcripts into written form in real time - [Keyword Boosting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/keyword-boosting.md): Boost specific words or phrases so the speech-to-text model recognizes them correctly - [Language detection](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/language-detection.md): Automatically detect and transcribe 30+ languages with Pulse STT - [Numeric Formatting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/numeric-formatting.md): Control how numbers are formatted in transcriptions - [PII and PCI Redaction](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/redaction.md): Automatically redact sensitive information from transcriptions - [Sentence-level timestamps](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/utterances.md): Use the utterances array to capture longer segments with speaker labels - [Word timestamps](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/features/word-timestamps.md): Return word-level timing metadata from Pulse STT - [Pulse](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/model-cards/pulse.md): High-accuracy, low-latency speech-to-text model built for real-time transcription across 39 languages, with streaming and non-streaming support. - [Overview](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/overview.md): Pulse STT API — transcribe audio in real-time or from files with 39 language support, diarization, and emotion detection. - [Audio Specifications](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/audio-formats.md): Supported formats, codecs, and recommendations for pre-recorded audio - [Best Practices](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/best-practices.md): Prepare audio inputs before submitting them to Pulse STT - [Code Examples](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/code-examples.md): Complete code samples for transcribing pre-recorded audio with Pulse STT - [Features](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/features.md): Available features for Pre-Recorded Pulse STT API - [Quickstart](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/quickstart.md): Get started with transcribing pre-recorded audio files using the Waves STT API - [Troubleshooting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/troubleshooting.md): Resolve common issues when uploading pre-recorded audio to Pulse STT - [Webhooks](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/pre-recorded/webhooks.md): Receive asynchronous Pulse STT results without polling - [Quickstart](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/quickstart.md): Transcribe your first audio file in under 60 seconds with Pulse STT. - [Audio Specifications](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/realtime/audio-formats.md): Supported audio encoding formats and requirements for real-time WebSocket transcription - [Best Practices](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/realtime/best-practices.md): Optimize your real-time WebSocket transcription for low latency and high accuracy - [Features](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/realtime/features.md): Available features for Real-Time Pulse STT WebSocket API - [Quickstart](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/realtime/quickstart.md): Get started with real-time transcription using the Pulse STT WebSocket API - [Response Format](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/realtime/response-format.md): Understanding the structure and fields of real-time transcription responses - [Troubleshooting](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/speech-to-text/realtime/troubleshooting.md): Common issues and solutions for real-time WebSocket transcription - [Voices & Languages](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/get-voice-models-langs.md): List available voices, models, and supported languages via the API. - [Sync & Async Synthesis](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/how-to-tts.md): Generate speech synchronously or concurrently — REST API and SDK examples. - [Lightning v3.1](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/model-cards/lightning-v3-1.md): Model card for Lightning v3.1. High-fidelity, low-latency text-to-speech at 44 kHz with voice cloning, streaming, and 15-language support. - [TTS Evaluation Script](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/model-cards/tts-evaluation.md): WebSocket-based evaluation script for measuring Lightning v3.1 TTFB and audio quality. - [Overview](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/overview.md): Lightning TTS API — generate speech from text with 80+ voices, 44.1 kHz audio, ~100ms latency, and streaming support. - [Pronunciation Dictionaries](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/pronunciation-dictionaries.md): Learn how to create and use pronunciation dictionaries to control how specific words are pronounced in your text-to-speech synthesis - [Quickstart](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/quickstart.md): Generate your first speech audio in under 60 seconds with Lightning TTS. - [Streaming](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/text-to-speech/stream-tts.md): Stream TTS audio in real-time via WebSocket or SSE — first chunk in ~100ms. - [Delete a Voice Clone](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/voice-cloning/how-to-delete-vc.md): Remove a cloned voice using the Python SDK. - [Instant Voice Clone (Python SDK)](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/voice-cloning/how-to-vc.md): Clone a voice from a short audio sample using the Python SDK. - [Instant Voice Clone (Web UI)](https://smallestai-ff1e543d.mintlify.app/v4.0.0/content/voice-cloning/how-to-vc-ui.md): Clone a voice from a short audio sample using the Smallest AI console. ## OpenAPI Specs - [tts-deprecated-api](https://smallestai-ff1e543d.mintlify.app/openapi-spec/tts-deprecated-api.yaml) - [tts-api](https://smallestai-ff1e543d.mintlify.app/openapi-spec/tts-api.yaml) - [voices-api](https://smallestai-ff1e543d.mintlify.app/openapi-spec/voices-api.yaml) - [pulse-stt-openapi](https://smallestai-ff1e543d.mintlify.app/openapi-spec/pulse-stt-openapi.yaml) - [pronunciation-dictionaries-api](https://smallestai-ff1e543d.mintlify.app/openapi-spec/pronunciation-dictionaries-api.yaml) - [asr-openapi](https://smallestai-ff1e543d.mintlify.app/openapi-spec/asr-openapi.yaml) - [openapi](https://smallestai-ff1e543d.mintlify.app/api-reference/openapi.json) ## AsyncAPI Specs - [pulse-stt-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/pulse-stt-ws.json) - [stream-tts-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/stream-tts-ws.json) - [lightning-v3.1-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/lightning-v3.1-ws.json) - [lightning-v2-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/lightning-v2-ws.json) - [lightning-asr-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/lightning-asr-ws.json) - [asr-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/asr-ws.json) - [pulse-asr-ws](https://smallestai-ff1e543d.mintlify.app/asyncapi-spec/pulse-asr-ws.json)