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

# Utiliser des dictionnaires de prononciation

> **Note**
>
> **Guide pratique** · Suppose que vous avez suivi le [démarrage rapide d’ElevenAPI](/docs/fr/eleven-api/quickstart).

## Présentation

Les dictionnaires de prononciation vous permettent de personnaliser la façon dont votre agent IA prononce des mots ou expressions spécifiques. Ils sont particulièrement utiles pour :

* Corriger la prononciation de noms, de lieux ou de termes techniques
* Garantir une prononciation cohérente dans toutes les conversations
* Personnaliser les variantes de prononciation régionales

ElevenLabs prend en charge les alphabets [IPA](https://en.wikipedia.org/wiki/International_Phonetic_Alphabet) et [CMU](https://en.wikipedia.org/wiki/CMU_Pronouncing_Dictionary).

> **Info**
>
> Les balises de phonèmes des dictionnaires de prononciation fonctionnent uniquement avec les modèles eleven_v4, eleven_flash_v2 et eleven_v3.
>
> Les autres modèles ignorent les balises de phonèmes du dictionnaire et utilisent la prononciation par défaut. Pour les autres modèles, utilisez plutôt des balises d’alias afin de remplacer des orthographes ou expressions et d’obtenir la prononciation souhaitée.
>
> Pour utiliser les prononciations IPA et CMU dans des langues autres que l’anglais, vous devrez passer au modèle eleven_v4.

## Démarrage rapide

> **Note**
>
> Ce guide suppose que vous avez [configuré votre clé API et votre SDK](/docs/fr/eleven-api/quickstart). Suivez d’abord le démarrage rapide si ce n’est pas encore fait.

#### Créer un fichier de dictionnaire de prononciation

Dans cet exemple, nous allons créer un fichier de dictionnaire de prononciation pour le mot `tomato`.

Cette règle utilisera l’alphabet « IPA » et modifiera la prononciation de `tomato` et `Tomato`. Les fichiers PLS sont sensibles à la casse, c’est pourquoi nous incluons les deux formes, avec et sans majuscule initiale « T ».

> **Tip**
>
> Vous pouvez utiliser des outils d’IA comme Claude ou ChatGPT pour vous aider à générer des notations IPA ou CMU pour des mots spécifiques.

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

#### Créer un dictionnaire de prononciation à partir d’un fichier via le SDK

Créez un fichier nommé `example.py` ou `example.mts`, selon le langage de votre choix, puis ajoutez le code suivant :

```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);
```

#### Exécuter le code

```python
python example.py
```

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

Vous devriez entendre deux versions de l’audio diffusées par vos haut-parleurs, l’une avec et l’autre sans dictionnaire de prononciation.

## Étapes suivantes

#### [Guide de l’API](/docs/fr/api-reference/pronunciation-dictionaries/create-from-file)

Guide complet de l’API des dictionnaires de prononciation.

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

Diffusez progressivement du texte en parole pour une lecture à plus faible latence.