FINDMYAIVOICE • SANTA DEVELOPER STARTER KIT • 1.0 • November 1, 2026

Jerry B - Jolly Santa Claus
Voice ID: MDLAMJ0jxkpYkjXbmG4t
Open this folder's index.html for the illustrated quick-start guide.

1. LISTEN AND ADD THE EXACT VOICE
https://elevenlabs.io/app/voice-library?voiceId=MDLAMJ0jxkpYkjXbmG4t
Sign in to ElevenLabs and add the voice to your library. Your own account,
voice access, plan and current platform terms govern generation and use.

2. RUN THE FREE LOCAL CHECKS (no API key, no network, no generation)
Install Node.js 22 or newer; no npm dependencies need installing.
Open a terminal in this extracted folder:
  node --test test.mjs
  node generate.mjs --dry-run
Dry-run prints the exact endpoint, model and character count, never your key.

3. GENERATE ONE SHORT FILE (uses YOUR ElevenLabs credits)
Copy .env.example to .env and enter your own API key in that local file.
Keep it on your server; do not place it in a webpage, VITE_/NEXT_PUBLIC_ env
variable, repository, downloadable ZIP, screenshot or client bundle.
  node --env-file=.env generate.mjs --generate
This writes santa-greeting.mp3. Listen before publishing. The example does
not estimate charges; confirm your current plan, voice rate and quota first.
The files in scripts/ are unvoiced copy, not approved or generated demos.

Other scripts:
  node --env-file=.env generate.mjs --generate --script scripts/retail-welcome.txt --output retail-welcome.mp3
  node --env-file=.env generate.mjs --generate --script scripts/story-intro.txt --output story-intro.mp3

Defaults: eleven_multilingual_v2, mp3_44100_128, 2,000 character request cap,
60 second timeout, no automatic retries. Model availability and rates can
change. Validate this voice/model in your own account before scaling.
An existing output filename is rejected. Use a new filename for each take.

4. USE AN AUDIO FILE ON YOUR PAGE
Copy your reviewed recording to your own public asset path, then:
  <audio controls preload="none" src="/audio/holiday-greeting.mp3"></audio>
This plays an existing file; it does not expose a key or generate new audio.
The web-preview.html file demonstrates the existing public voice preview.

5. BUILD A CONVERSATIONAL SANTA
See AGENT-GUIDE.txt. A TTS voice ID is NOT an agent ID. This kit does not
create or launch a live agent, collect microphone audio or make phone calls.

6. SCALE DELIBERATELY
Review pronunciation, pacing and brand terms on short samples. Queue bounded
jobs, use deduplication/cache keys incorporating voice/model/script/settings,
and handle 429/quota errors with explicit operator review. A timeout can
still consume credits; inspect request history before retrying. This small
example is a local/server-side starting point, not a public generation API.
Add your application's authentication, authorization, abuse limits, budget
limits, privacy controls and operational monitoring before production use.
For family experiences, use an adult-facing setup and obtain appropriate
privacy review before collecting children's data. Do not put sensitive data
in URLs or analytics. Sample scripts intentionally contain no child details.

7. MEASUREMENT AND SHARING
Use the prepared entry link in TRACKING.txt for distribution under
FindMyAIVoice. Only use prospect-specific links after owner approval.
Site visits/listening/ElevenLabs click-through are funnel signals; they do
not establish voice additions, generated characters, customers or revenue.
Direct API use of the voice does not automatically report to FindMyAIVoice.

VERIFIED PRIMARY SOURCES (checked November 1, 2026)
Official tutorial selects this exact voice ID:
https://elevenlabs.io/blog/add-a-santa-voice-agent-to-your-react-app-in-minutes
Featured in an official ElevenLabs Santa Voice Agent developer tutorial.
This is not an official ranking, award, endorsement of FindMyAIVoice or
commercial partnership. FindMyAIVoice is a separate discovery website.
API request reference:
https://elevenlabs.io/docs/api-reference/text-to-speech/convert
React SDK:
https://elevenlabs.io/docs/eleven-agents/libraries/react
Authentication:
https://elevenlabs.io/docs/eleven-agents/customization/authentication
Commercial-use terms: review your current ElevenLabs account terms and plan
before launch; the kit grants no rights beyond the example source code.

SOURCE CODE PERMISSION
You may use, adapt and redistribute this kit's original example code in
your applications. Supplied as-is, without warranty. This permission does
not license the voice, audio preview, ElevenLabs trademarks or services.

VALIDATION SCOPE
Mocked API tests and CLI dry-run tested; no paid audio generated and no
authenticated live TTS call made during preparation. Run a short real test
in your own account before a commercial launch. No prospects contacted.
