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

# Dizionari di pronuncia

## Panoramica

I dizionari di pronuncia ti permettono di personalizzare il modo in cui il tuo agente IA pronuncia parole o frasi specifiche. Sono particolarmente utili per:

* Correggere la pronuncia di nomi, luoghi o termini tecnici
* Garantire una pronuncia coerente nelle conversazioni
* Personalizzare le varianti di pronuncia regionali

## Configurazione

> **Note**
>
> I tag dei fonemi del dizionario di pronuncia funzionano solo con i modelli eleven\_v4, eleven\_flash\_v2 e eleven\_v3.
>
> Gli altri modelli ignorano i tag dei fonemi del dizionario e usano la pronuncia predefinita. Per gli altri modelli, usa invece i tag alias per sostituire grafie o frasi che producono la pronuncia desiderata.
>
> Se vuoi usare le pronunce IPA e CMU in lingue diverse dall'inglese, dovrai passare ai modelli eleven\_v3 o eleven\_v4.

### Associa un dizionario al tuo agente

#### Aggiorna dalla dashboard

Apri il tuo agente nella dashboard, vai a **Impostazioni voce** e aggiungi un dizionario di pronuncia. Salva le modifiche.

![Aggiungi un dizionario di pronuncia dalle impostazioni vocali dell'agente](/docs/_fern-files/elevenlabs.docs.buildwithfern.com/1e7c851096776b9b8cb39cc95b54d394cc02ec7e4771d13958a259accf0ad757/assets/images/conversational-ai/pd-agents.webp)

#### Aggiorna tramite la CLI

#### Recupera la configurazione dell'agente

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

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

Imposta `conversation_config.tts.pronunciation_dictionary_locators`:

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

#### Invia le modifiche

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

#### Aggiorna tramite l'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>",
        },
      ],
    },
  },
});
```

## Formato del file del dizionario

I dizionari di pronuncia usano file `.pls` basati su XML. Ecco un esempio della struttura:

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

## Formati supportati

I dizionari di pronuncia supportano due tipi di notazione della pronuncia:

1. **IPA (Alfabeto Fonetico Internazionale)**

   * Controllo più preciso della pronuncia
   * Richiede la conoscenza dei simboli IPA
   * Esempio: "nginx" come `/ˈɛndʒɪnˈɛks/`

2. **Formato del dizionario CMU (Carnegie Mellon University)**
   * Formato ASCII più semplice
   * Più accessibile per le pronunce in inglese
   * Esempio: "tomato" come "T AH M EY T OW"

> **Tip**
>
> Puoi usare strumenti IA come Claude o ChatGPT per generare notazioni IPA o CMU per parole specifiche.

## Buone pratiche

1. **Maiuscole e minuscole**: se necessario, crea voci separate per le versioni delle parole con iniziale maiuscola e minuscola
2. **Test**: testa sempre le pronunce con la voce e il modello scelti
3. **Manutenzione**: mantieni il dizionario organizzato e documentato
4. **Ambito**: concentrati sulle parole spesso pronunciate in modo errato o fondamentali per il tuo caso d'uso

## FAQ

#### Quali modelli supportano la pronuncia basata sui fonemi?

I tag dei fonemi del dizionario di pronuncia funzionano solo con i modelli eleven\_v4, eleven\_flash\_v2 e eleven\_v3.

Gli altri modelli ignorano i tag dei fonemi del dizionario e usano la pronuncia predefinita. Per gli altri modelli, usa invece i tag alias per sostituire grafie o frasi che producono la pronuncia desiderata.

Se vuoi usare le pronunce IPA e CMU in lingue diverse dall'inglese, dovrai passare al modello eleven\_v4 o eleven\_v3.

#### Posso usare più dizionari?

Sì, puoi caricare più file di dizionario per gestire diversi set di pronunce.

#### Cosa succede se una parola non è nel dizionario?

Il modello userà le proprie regole di pronuncia predefinite per le parole non specificate nel dizionario.

## Risorse aggiuntive

* [Clonazione Vocale Professionale](/docs/it/eleven-creative/voices/voice-cloning/professional-voice-cloning)
* [Voice Design](/docs/it/eleven-creative/voices/voice-design)
* [Riferimento API Text to Speech](/docs/it/api-reference/text-to-speech/convert)