Skip to navigation
Praktische handleidingenText to Speech

Uitspraakwoordenboeken gebruiken

In deze handleiding leer je hoe je uitspraakwoordenboeken programmatisch beheert.

Handleiding · Hierbij wordt ervan uitgegaan dat je de ElevenAPI- snelstart hebt voltooid.

Overzicht

Met uitspraakwoordenboeken kun je aanpassen hoe je AI-agent specifieke woorden of zinnen uitspreekt. Dit is vooral handig voor:

  • Het corrigeren van de uitspraak van namen, plaatsen of technische termen
  • Het zorgen voor een consistente uitspraak in gesprekken
  • Het aanpassen van regionale uitspraakvariaties

ElevenLabs ondersteunt zowel de alfabetten IPA als CMU.

Foneemtags in uitspraakwoordenboeken werken alleen met de modellen eleven_v4, eleven_flash_v2 en eleven_v3.

Andere modellen slaan foneemtags uit woordenboeken over en gebruiken de standaarduitspraak. Gebruik voor andere modellen in plaats daarvan aliastags om spellingen of zinnen te vervangen die de uitspraak opleveren die je nodig hebt.

Als je IPA- en CMU-uitspraken wilt gebruiken in andere talen dan Engels, moet je overschakelen naar het model eleven_v4.

Snelstart

In deze handleiding wordt ervan uitgegaan dat je je API-sleutel en SDK hebt ingesteld. Voltooi eerst de snelstart als je dat nog niet hebt gedaan.

1

Een uitspraakwoordenboekbestand maken

In dit voorbeeld maken we een uitspraakwoordenboekbestand voor het woord tomato.

Deze regel gebruikt het alfabet “IPA” en wijzigt de uitspraak van tomato en Tomato naar een andere uitspraak. PLS-bestanden zijn hoofdlettergevoelig, daarom nemen we het woord zowel met als zonder hoofdletter “T” op.

Je kunt AI-tools zoals Claude of ChatGPT gebruiken om IPA- of CMU-notaties voor specifieke woorden te helpen genereren.

dictionary.pls
<?xml version="1.0" encoding="UTF-8"?>
<lexicon version="1.0"
    xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
        http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
    alphabet="ipa" xml:lang="en-US">
<lexeme>
    <grapheme>tomato</grapheme>
    <phoneme>/tə'meɪtoʊ/</phoneme>
</lexeme>
<lexeme>
    <grapheme>Tomato</grapheme>
    <phoneme>/tə'meɪtoʊ/</phoneme>
</lexeme>
</lexicon>
2

Een uitspraakwoordenboek maken vanuit een bestand via de SDK

Maak een nieuw bestand met de naam example.py of example.mts, afhankelijk van de programmeertaal die je kiest, en voeg de volgende code toe:

from elevenlabs import ElevenLabs, PronunciationDictionaryVersionLocator
from elevenlabs.play import play
elevenlabs = ElevenLabs()
with open("dictionary.pls", "rb") as f:
    # this dictionary changes how tomato is pronounced
    pronunciation_dictionary = elevenlabs.pronunciation_dictionaries.create_from_file(
        file=f.read(), name="example"
    )
audio_1 = elevenlabs.text_to_speech.convert(
    text="Without the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_flash_v2",
)
audio_2 = elevenlabs.text_to_speech.convert(
    text="With the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_flash_v2",
    pronunciation_dictionary_locators=[
        PronunciationDictionaryVersionLocator(
            pronunciation_dictionary_id=pronunciation_dictionary.id,
            version_id=pronunciation_dictionary.version_id,
        )
    ],
)
# play the audio
play(audio_1)
play(audio_2)
3

De code uitvoeren

python example.py

Je zou twee versies van de audio via je speakers moeten horen: één met en één zonder het uitspraakwoordenboek.

Volgende stappen

API-referentie

Volledige API-referentie voor uitspraakwoordenboeken.

TTS-streaming

Stream tekst progressief naar spraak voor afspelen met lagere latency.