> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Uitspraakwoordenboeken gebruiken

> **Note**
>
> **Handleiding** · Hierbij wordt ervan uitgegaan dat je de [ElevenAPI- snelstart](/docs/nl/eleven-api/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 uitspraakvariaties

ElevenLabs ondersteunt zowel de alfabetten [IPA](https://en.wikipedia.org/wiki/International_Phonetic_Alphabet) als [CMU](https://en.wikipedia.org/wiki/CMU_Pronouncing_Dictionary).

> **Info**
>
> 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

> **Note**
>
> In deze handleiding wordt ervan uitgegaan dat je [je API-sleutel en SDK hebt ingesteld](/docs/nl/eleven-api/quickstart). Voltooi
> eerst de snelstart als je dat nog niet hebt gedaan.

#### 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.

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

**`dictionary.pls`**

```xml title="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>
```

#### 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:

```python maxLines=0
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)
```

```typescript maxLines=0
import { ElevenLabsClient, play } from "@elevenlabs/elevenlabs-js";
import "dotenv/config";
import fs from "node:fs";

const elevenlabs = new ElevenLabsClient();

const pronunciationDictionary = await elevenlabs.pronunciationDictionaries.createFromFile({
    file: fs.createReadStream("dictionary.pls"),
});

const audio1 = await elevenlabs.textToSpeech.convert("Without the dictionary: tomato", {
    voiceId: "aMSt68OGf4xUZAnLpTU8",
    modelId: "eleven_flash_v2",
});

const audio2 = await elevenlabs.textToSpeech.convert("With the dictionary: tomato", {
    voiceId: "aMSt68OGf4xUZAnLpTU8",
    modelId: "eleven_flash_v2",
    pronunciationDictionaryLocators: [
        {
            pronunciationDictionaryId: pronunciationDictionary.id,
            versionId: pronunciationDictionary.versionId,
        },
    ],
});

play(audio1);
play(audio2);
```

#### De code uitvoeren

```python
python example.py
```

```typescript
npx tsx example.mts
```

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

## Volgende stappen

#### [API-referentie](/docs/nl/api-reference/pronunciation-dictionaries/create-from-file)

Volledige API-referentie voor uitspraakwoordenboeken.

#### [TTS-streaming](/docs/nl/eleven-api/guides/how-to/text-to-speech/streaming)

Stream tekst progressief naar spraak voor afspelen met lagere latency.