Skip to navigation
Praktische handleidingenText to Speech

Uitspraakwoordenboeken gebruiken

In deze handleiding lees je hoe je uitspraakwoordenboeken programmatisch beheert.

Handleiding · Hierbij wordt ervan uitgegaan dat je de ElevenAPI- quickstart 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 uitspraakvarianten

ElevenLabs ondersteunt zowel de IPA- als de CMU-alfabetten.

Foneemtags voor uitspraakwoordenboeken werken alleen met de modellen eleven_v4, eleven_v4_turbo, 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 overstappen op het model eleven_v4 of eleven_v4_turbo.

Quickstart

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

1

Maak een uitspraakwoordenboekbestand

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 in 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 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

Maak via de SDK een uitspraakwoordenboek vanuit een bestand

Maak een nieuw bestand met de naam example.py of example.mts, afhankelijk van de taal 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_v4_turbo",
)
audio_2 = elevenlabs.text_to_speech.convert(
    text="With the dictionary: tomato",
    voice_id="aMSt68OGf4xUZAnLpTU8",
    model_id="eleven_v4_turbo",
    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

Voer de code uit

python example.py

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

Volgende stappen

API-referentie

Volledige API-referentie voor uitspraakwoordenboeken.

TTS-streaming

Stream text-to-speech geleidelijk voor afspelen met lagere latency.