ComfyUI-ElevenLabs-Pro

Full-featured ElevenLabs API integration for ComfyUI. 30 nodes: TTS, Speech-to-Speech, Sound Effects, Music, Voice Cloning / Design / Remix, Multi-speaker Dialogue, Speech-to-Text, Forced Alignment, Audio Isolation — plus 11 pure-Python audio utility nodes (subtitle export, concat, normalize, trim, channels, save, cost estimator, …).

Install

cd ComfyUI/custom_nodes
git clone https://github.com/IxMxAMAR/ComfyUI-ElevenLabs-Pro.git
pip install -r ComfyUI-ElevenLabs-Pro/requirements.txt

Then restart ComfyUI.

API key

Set the ELEVENLABS_API_KEY environment variable, or paste your key into the ElevenLabs Pro - API Key node. Keys are scrubbed from any raised error message so they never end up in ComfyUI logs or saved workflow PNG metadata.

Nodes (30 total)

Voice — 7 nodes

Node	Purpose
Voice Selector	Pick a predefined voice OR pass a custom voice_id.
Fetch Voices	List your account's voices (premade / cloned / generated / professional) with search + gender filter. Cached 5 min.
Get Voice By Name	Look up a voice_id by name (exact / contains / starts-with).
Voice Clone	Instant voice clone from up to 8 audio samples. create=False by default — flip to True to actually upload (prevents accidental slot/credit burn on workflow re-queue).
Voice Design	Generate 3 voice previews from a text description (eleven_multilingual_ttv_v2 or eleven_ttv_v3, optional reference audio, loudness, guidance, seed). Returns all 3 IDs; pick one with preview_index. Sample text under 100 characters is auto-generated.
Voice Remix	Remix an existing voice from a description of the changes. Same outputs as Voice Design.
Voice Create	Save a designed or remixed preview as a permanent library voice (description of 20-1000 characters required). Also gated by create=True.

TTS — 5 nodes

Node	Purpose
Text to Speech	Full TTS with every API parameter (stability, similarity, style, speed, speaker boost, language, normalization, seed, previous/next text, PVC-as-IVC, enable_logging, pronunciation dicts, Japanese language normalization). Auto-validates eleven_v3 normalization, turbo language requirement.
TTS with Timestamps	TTS + character-level alignment JSON, with voice settings, language, normalization and previous/next text.
Text to Dialogue	Multi-speaker (up to 10) eleven_v3 / eleven_v4 dialogue with previous/future text, PVC-as-IVC and pronunciation dictionaries. Total text length validated.
Text to Dialogue with Timestamps	Same inputs as Text to Dialogue, plus character-level alignment JSON and per-voice segments JSON.
Voice Tag Inserter	Pure-text helper — dropdown of v3 expression tags ([whispers], [laughs], [excited], …) injected into your prompt.

Audio (API) — 5 nodes

Node	Purpose
Speech to Speech	Transform an AUDIO input to another voice.
Sound Effects	Text → SFX with duration (or model-chosen duration) / prompt_influence / loop / seed. Uses the eleven_text_to_sound_v2 model id.
Audio Isolation	Remove background noise / isolate vocals.
Speech to Text	Transcribe AUDIO via scribe_v2 or scribe_v2_medical, with diarization, speaker roles, multichannel, audio-event tagging, keyterms, no-verbatim, transcript editing (edited_text output), temperature, seed.
Forced Alignment	Align a known transcript to AUDIO and get word-level timings (feeds Subtitle Export).

Music — 2 nodes

Node	Purpose
Music Generation	Text-prompt OR composition_plan JSON, with music_v1 / music_v2 / music_v2_5. 3 – 600 s. Lyrics, generation mode, finetunes, force instrumental, respect section durations, C2PA signing.
Music Composition Plan	Prompt → composition plan JSON to edit and feed into Music Generation.

Audio (pure-Python utilities) — 7 nodes

Node	Purpose
Subtitle Export (SRT/VTT)	Convert TTSTimestamps alignment or STT words into SRT or VTT. Cue grouping by char count + seconds.
Audio Concat	Stitch up to 8 clips. Resamples mismatched SRs (torchaudio or linear-interp fallback). Broadcasts mono → stereo. Optional silence gap.
Audio Normalize	Peak / RMS normalization to a target dBFS.
Audio Metadata	Read duration_seconds, sample_rate, channels, samples.
Audio Channels	to-mono / to-stereo / left-only / right-only / swap.
Audio Trim	Trim by start / end seconds.
Save Audio	Write AUDIO to disk under ComfyUI/output as wav / mp3 / flac / ogg. Sanitized filename + subdir (no .. traversal).

Utilities — 2 nodes

Node	Purpose
Cost Estimator	Estimate credit cost from text + model before the API call.
Voice Settings Preset	Build a voice_settings JSON blob for reuse across workflows.

Config — 2 nodes

Node	Purpose
API Key	Hold the key and pass it to other nodes. password=True masks it in the UI.
Account Info	Subscription tier + character usage. PII-redacted by default — email, name, billing IDs are stripped before being returned so saved workflows don't leak your identity.

Models

TTS

• eleven_v4 — most expressive, 90+ languages (10 000 char limit)
• eleven_v3 — expressive, supports [whispers]/[laughs]/v3 tags (5 000 char limit, auto-forces normalization=off)
• eleven_multilingual_v2 (10 000 chars)
• eleven_flash_v2_5, eleven_turbo_v2_5 (40 000 chars, require explicit language)
• eleven_flash_v2, eleven_turbo_v2 (English-only, 30 000 chars)

eleven_monolingual_v1 and eleven_multilingual_v1 were removed by ElevenLabs on 2026-07-09.

Dialogue

• eleven_v3, eleven_v4

Speech-to-Speech

• eleven_multilingual_sts_v2, eleven_english_sts_v2

Speech-to-Text

• scribe_v2, scribe_v2_medical (scribe_v1 was removed on 2026-07-09)

Voice Design

• eleven_multilingual_ttv_v2, eleven_ttv_v3

SFX

• eleven_text_to_sound_v2

Music

• music_v1, music_v2, music_v2_5

Output formats

All standard ElevenLabs formats supported: mp3 (44.1k @ 192/128/96/64/32, 24k @ 48, 22k @ 32), wav (44.1k / 48k / 32k / 24k / 22k / 16k / 8k), pcm (44.1k / 48k / 32k / 24k / 22k / 16k / 8k), opus (48k @ 192/128/96/64/32). Music Generation also accepts mp3 (48k @ 128/192/240/320).

The PCM path is decoded directly as int16 little-endian mono so it works without an MP3 decoder. WAV / MP3 / Opus use soundfile first, fall back to torchaudio.

Security

This v2.1 release went through a top-to-bottom audit. Highlights:

• API key never leaks. scrub_secrets() removes the key from every raised exception, error message, and the IS_CHANGED hash (so the key never enters workflow PNG metadata).
• AccountInfo PII redacted. Email, name, billing IDs stripped before returning. Uses /v1/user/subscription by default (no PII).
• VoiceClone / VoiceCreate require explicit create=True. v2.0 burned a voice slot on every queue prompt; v2.1 default is dry-run.
• All paid API nodes cache by input hash. v2.0 used IS_CHANGED = NaN which forced every queue to re-bill the API.
• Download size cap (500 MB default). No more OOM from a malicious endpoint.
• Multipart uploads survive retries. File pointers reset to 0 between attempts (v2.0 sent empty bodies on retry).
• SaveAudio rejects path traversal. Subdirectory and filename are sanitized so a malicious workflow can't write ../../etc/passwd.

Tests

cd ComfyUI/custom_nodes/ComfyUI-ElevenLabs-Pro
python -m pytest tests/ -c pytest.ini

153 / 153 passing. All HTTP mocked — no real ElevenLabs credits consumed during testing.

License

MIT.