> 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

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

## Configuratie

> **Note**
>
> Foneemtags in uitspraakwoordenboeken werken alleen met de modellen eleven\_v4, eleven\_flash\_v2 en eleven\_v3.
>
> Andere modellen slaan foneemtags in woordenboeken over en gebruiken de standaarduitspraak. Gebruik voor andere modellen
> in plaats daarvan aliastags om spellingen of zinnen te vervangen die de gewenste uitspraak opleveren.
>
> Als je IPA- en CMU-uitspraken wilt gebruiken in andere talen dan Engels, moet je overschakelen
> naar de modellen eleven\_v3 of eleven\_v4.

### Een woordenboek aan je agent koppelen

#### Bijwerken via het dashboard

Open je agent in het dashboard, ga naar **Steminstellingen** en voeg een uitspraakwoordenboek toe. Sla je wijzigingen op.

![Een uitspraakwoordenboek toevoegen vanuit de steminstellingen van de agent](/docs/_fern-img/1e7c851096776b9b8cb39cc95b54d394cc02ec7e4771d13958a259accf0ad757.webp)

#### Bijwerken via de CLI

#### De agentconfiguratie ophalen

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### \`agent\_configs/\<agent-name>.json\` bewerken

Stel `conversation_config.tts.pronunciation_dictionary_locators` in:

```json
{
  "conversation_config": {
    "tts": {
      "pronunciation_dictionary_locators": [
        {
          "pronunciation_dictionary_id": "<dictionary-id>",
          "version_id": "<version-id>"
        }
      ]
    }
  }
}
```

#### Je wijzigingen pushen

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Bijwerken via de API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "tts": {
            "pronunciation_dictionary_locators": [
                {
                    "pronunciation_dictionary_id": "<dictionary-id>",
                    "version_id": "<version-id>",
                }
            ]
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    tts: {
      pronunciationDictionaryLocators: [
        {
          pronunciationDictionaryId: "<dictionary-id>",
          versionId: "<version-id>",
        },
      ],
    },
  },
});
```

## Bestandsindeling van woordenboeken

Uitspraakwoordenboeken gebruiken XML-gebaseerde `.pls`-bestanden. Dit is een voorbeeldstructuur:

```xml
<?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-GB">
  <lexeme>
    <grapheme>Apple</grapheme>
    <phoneme>ˈæpl̩</phoneme>
  </lexeme>
  <lexeme>
    <grapheme>UN</grapheme>
    <alias>United Nations</alias>
  </lexeme>
</lexicon>
```

## Ondersteunde indelingen

Uitspraakwoordenboeken ondersteunen twee typen uitspraaknotatie:

1. **IPA (International Phonetic Alphabet)**

   * Nauwkeurigere controle over de uitspraak
   * Vereist kennis van IPA-symbolen
   * Voorbeeld: "nginx" als `/ˈɛndʒɪnˈɛks/`

2. **CMU-indeling (Carnegie Mellon University)-woordenboekindeling**
   * Eenvoudigere ASCII-gebaseerde indeling
   * Toegankelijker voor Engelse uitspraken
   * Voorbeeld: "tomato" als "T AH M EY T OW"

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

## Best practices

1. **Hoofdlettergevoeligheid**: Maak indien nodig afzonderlijke vermeldingen voor versies van woorden met hoofdletters en kleine letters
2. **Testen**: Test uitspraken altijd met de door jou gekozen stem en het gekozen model
3. **Onderhoud**: Houd je woordenboek overzichtelijk en gedocumenteerd
4. **Bereik**: Richt je op woorden die vaak verkeerd worden uitgesproken of cruciaal zijn voor je use case

## Veelgestelde vragen

#### Welke modellen ondersteunen op fonemen gebaseerde uitspraak?

Foneemtags in uitspraakwoordenboeken werken alleen met de modellen eleven\_v4, eleven\_flash\_v2 en eleven\_v3.

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

Als je IPA- en CMU-uitspraken wilt gebruiken in andere talen dan Engels, moet je overschakelen
naar het model eleven\_v4 of eleven\_v3.

#### Kan ik meerdere woordenboeken gebruiken?

Ja, je kunt meerdere woordenboekbestanden uploaden voor verschillende sets uitspraken.

#### Wat gebeurt er als een woord niet in het woordenboek staat?

Het model gebruikt de standaardregels voor uitspraak voor woorden die niet in het
woordenboek staan.

## Aanvullende bronnen

* [Professioneel stemklonen](/docs/nl/eleven-creative/voices/voice-cloning/professional-voice-cloning)
* [Voice Design](/docs/nl/eleven-creative/voices/voice-design)
* [API-referentie voor Text to Speech](/docs/nl/api-reference/text-to-speech/convert)