primer · voice

Four ElevenLabs primitives, demystified.

Every idea in this repo leans on one of four ElevenLabs primitives. Each one runs against the public ElevenLabs API with a single key, so you ship a real voice demo with zero infra and nothing to host.

The one-key protocol

Add this in your Lovable project (Settings → Secrets) before pasting any mega-prompt:

ELEVENLABS_API_KEYSingle API key that unlocks TTS, voice agents, scribe, music and SFX. Free tier covers a hackathon weekend.open ↗

streaming voice

ElevenLabs Text-to-Speech

250 ideas use this

kernel

an /audio/speech call to ElevenLabs (model eleven_turbo_v2_5 for streaming, eleven_multilingual_v2 for quality) that returns MP3 / PCM and plays it as the user reads or interacts

how it drives the UI

a 'play' button (or auto-play) that streams lifelike narration of any text the app generates

EXAMPLE IDEAS

live conversation

Conversational Voice Agent

250 ideas use this

kernel

an ElevenLabs Agent over WebRTC via the @elevenlabs/react useConversation hook — server mints a single-use conversation token, client speaks and listens in real time

how it drives the UI

a microphone button that opens a back-and-forth voice conversation with an agent tuned for the discipline

EXAMPLE IDEAS

live transcription

Realtime Speech-to-Text

250 ideas use this

kernel

the @elevenlabs/react useScribe hook on scribe_v2_realtime — server mints a single-use scribe token, client streams microphone audio and receives partial + committed transcripts with word timestamps

how it drives the UI

a live caption strip that types itself as the user speaks, with finalized lines saved as the user pauses

EXAMPLE IDEAS

audio generation

Generative Music & SFX

250 ideas use this

kernel

ElevenLabs /v1/sound-generation (≤2022s SFX) and /v1/music (studio tracks) — server takes a text prompt and returns an MP3 the client plays or downloads

how it drives the UI

a prompt box that conjures a sound effect, sting, or short track on demand and pipes it into the workspace

EXAMPLE IDEAS