creativeclawco Creative Claw — ElevenLabs Multilingual v2
Use speech/elevenlabs-v2 for controlled, natural narration. It uses the same existing ElevenLabs voice or Character as v3. Selecting v2 does not create or upgrade a Professional Voice Clone (PVC); Instant Voice Cloning and PVC are separate voice-creation methods.
Choose deliberately
| Need | Model |
|---|---|
| Corporate presenter, restrained explainer, e-learning, audiobook | Multilingual v2 |
| Assess how well an existing clone preserves a speaker in ordinary narration | Start with v2; compare the same clone and script if another audition is requested |
| Acting, laughter, whispers, emotional performance tags | v3 |
| Hebrew or another language outside v2's supported set | v3 or another explicitly compatible model |
An explicit user model choice wins. V2 is our workflow recommendation for steady narration, not a provider guarantee of better similarity. Do not recreate a clone to change TTS models. Creating another clone can alter its sound even from identical source audio.
Execute
- Reuse the supplied script, speaker, language and delivery. Infer minor defaults without restarting the brief.
- Call
get_model_params({ model: "speech/elevenlabs-v2" })once for current settings, supported languages, a runnable example and the curated voice catalog. Uselist_models({ category: "speech" })when selecting alternatives. - Reuse the requested
character_idfor an existing consented clone, or choose a catalogvoice_idmatching language, accent, age and energy. If cloning is needed, usecreativeclaw-clone-voicewith the speaker's permission. Do not silently substitute a stock voice. - Preserve approved words. Add only supported punctuation or permitted pronunciation edits. For a straightforward approved script, generate directly; do not require an extra audition. Audition first when evaluating clone identity or resolving material uncertainty.
- Call
generate_speechwith the explicit model. Preserve the output URL and job ID. Listen with available tools; never claim listening from file metadata alone. - For another attempt, change one variable. Reuse the same voice, script and output format to make comparisons meaningful.
Script and pause rules
V2 does not understand v3 square-bracket performance tags such as [calm], [excited], [pause], [whispers], or [laughs]. They may be spoken or misinterpreted. Do not add them. If approved input contains these, explain the incompatibility and adapt only with permission to edit the script; never silently remove meaningful bracketed text.
Use sentence structure, commas and full stops for natural rhythm. A sparse SSML pause such as <break time="0.5s" /> is supported, up to 3 seconds. Too many breaks can produce artifacts. V3 supports its audio tags but does not support these SSML breaks. Neither model supports phoneme tags through this workflow.
Keep production direction outside spoken text: “warm, confident founder” belongs in casting decisions, not as a sentence the voice will read. V2's emotion comes mainly from the reference performance and textual context, not a generic emotion field.
Settings that actually reach the model
Top level: model, text, voice_id or character_id, optional speed.
Inside extras: voice_settings, output_format, seed, timestamps, apply_text_normalization, previous_text, next_text.
| Setting inside extras.voice_settings | Starting value | Practical adjustment |
|---|---|---|
| stability | 0.5 | Raise modestly for inconsistent delivery; lower for flat delivery. Range 0–1. |
| similarity_boost | 0.75 | Raise carefully when resemblance is weak; high values can reproduce source artifacts. Range 0–1. |
| style | 0 | Start here. Increasing exaggerates the source performance and may add latency or instability. Range 0–1. |
| use_speaker_boost | true | May help resemblance at additional latency. |
| speed | 1 | Adjust gently within 0.7–1.2. Extreme values can hurt quality. |
Legacy flat fields such as extras.stability still work. Prefer nested extras.voice_settings; nested values win over flat aliases, and explicit top-level speed wins over both. Do not duplicate fields unnecessarily. V3 only exposes stability and speed; legacy similarity, style and speaker boost fields are ignored there.
{
"model": "speech/elevenlabs-v2",
"character_id": "<existing Character UUID>",
"text": "Welcome to our annual conference. Today, we bring the industry together to discuss real projects, investment and delivery.",
"extras": {
"voice_settings": {
"stability": 0.5,
"similarity_boost": 0.75,
"style": 0,
"use_speaker_boost": true,
"speed": 1
},
"output_format": "mp3_44100_128",
"timestamps": true
}
}
For a catalog voice, replace character_id with a discovered voice_id. Do not pass source audio_url to ElevenLabs TTS. No agentic_prompting parameter is exposed by generate_speech.
Languages and pronunciation
V2 supports English, Japanese, Chinese, German, Hindi, French, Korean, Portuguese, Italian, Spanish, Indonesian, Dutch, Turkish, Filipino, Polish, Swedish, Bulgarian, Romanian, Arabic, Czech, Greek, Finnish, Croatian, Malay, Slovak, Danish, Tamil, Ukrainian and Russian. Check discovery for current support. Hebrew is not supported.
Write in the target language. The v2 API does not support language_code; language is inferred from the script. The source voice influences accent, so a model switch cannot guarantee a native accent.
For names and dates, use approved spoken spellings when needed: “twenty twenty-seven,” or letters separated with punctuation. Multilingual v2 does not support phoneme tags. Do not invent dictionary IDs or promise pronunciation dictionaries unless the runtime exposes that capability.
Longer narration
Maximum request length is 10,000 characters. Split at paragraphs or sentences into manageable passages, keeping voice and settings fixed. extras.previous_text and extras.next_text may contain adjacent script context; these fields guide continuity without being spoken in the current output. Do not duplicate adjacent passages inside text.
Character alignment is requested by default. Use returned timings rather than guessed word timings. For assembly, follow the voiceover workflow's media-assembly guidance and verify joins, silence and total duration. Do not claim that stored audio is automatically mixed into a film.
Diagnose before spending again
- Wrong words or names: adjust an approved spelling or punctuation.
- Flat read: lower stability modestly; assess whether the source performance is itself flat.
- Wavering identity: keep style at zero, keep the same clone, compare a small similarity change.
- Hiss, room sound or unnatural artifacts: inspect the source before increasing similarity.
- Good recording but poor resemblance: IVC has limitations; do not promise v2 fixes every voice.
- Needs laughter or acted emotional direction: offer v3 with the same Character and a suitable script.
- Provider failure: report the failure; do not silently switch models or voices.
For cloning guidance, recommend 1–2 minutes of consistent solo speech: recommended minimum 1 minute, recommended maximum 3 minutes. These are quality recommendations, not hard API duration limits. Preserve the source and the useful clone; replacement currently deletes the old voice.