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

# Diccionarios de pronunciación

## Descripción general

Los diccionarios de pronunciación te permiten personalizar cómo pronuncia tu agente de IA palabras o frases específicas. Esto resulta especialmente útil para:

* Corregir la pronunciación de nombres, lugares o términos técnicos
* Garantizar una pronunciación coherente entre conversaciones
* Personalizar variaciones regionales de pronunciación

## Configuración

> **Note**
>
> Las etiquetas de fonemas de los diccionarios de pronunciación solo funcionan con los modelos eleven_v4, eleven_flash_v2 y eleven_v3.
>
> Otros modelos omiten las etiquetas de fonemas del diccionario y usan la pronunciación predeterminada. Para otros modelos, usa
> etiquetas de alias para sustituir grafías o frases que produzcan la pronunciación que necesitas.
>
> Si quieres usar pronunciaciones IPA y CMU en idiomas distintos del inglés, tendrás que
> cambiar a los modelos eleven_v3 o eleven_v4.

### Asocia un diccionario a tu agente

#### Actualizar desde el panel

Abre tu agente en el panel, ve a **Configuración de voz** y añade un diccionario de pronunciación. Guarda los cambios.

![Añade un diccionario de pronunciación desde la configuración de voz del agente](/docs/_fern-img/1e7c851096776b9b8cb39cc95b54d394cc02ec7e4771d13958a259accf0ad757.webp)

#### Actualizar mediante la CLI

#### Descarga la configuración del agente

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

#### Edita \`agent_configs/\<agent-name>.json\`

Configura `conversation_config.tts.pronunciation_dictionary_locators`:

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

#### Envía tus cambios

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

#### Actualizar mediante la 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 archivo de diccionario

Los diccionarios de pronunciación usan archivos `.pls` basados en XML. Esta es una estructura de ejemplo:

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

## Formatos compatibles

Los diccionarios de pronunciación admiten dos tipos de notación de pronunciación:

1. **IPA (Alfabeto Fonético Internacional)**

   * Control más preciso de la pronunciación
   * Requiere conocer los símbolos IPA
   * Ejemplo: "nginx" como `/ˈɛndʒɪnˈɛks/`

2. **Formato de diccionario CMU (Universidad Carnegie Mellon)**
   * Formato más sencillo basado en ASCII
   * Más accesible para pronunciaciones en inglés
   * Ejemplo: "tomato" como "T AH M EY T OW"

> **Tip**
>
> Puedes usar herramientas de IA como Claude o ChatGPT para generar notaciones IPA o CMU de palabras
> específicas.

## Recomendaciones

1. **Distinción entre mayúsculas y minúsculas**: crea entradas independientes para las versiones en mayúsculas y minúsculas de las palabras si es necesario
2. **Pruebas**: prueba siempre las pronunciaciones con la voz y el modelo que hayas elegido
3. **Mantenimiento**: mantén tu diccionario organizado y documentado
4. **Alcance**: céntrate en palabras que se pronuncien mal con frecuencia o que sean esenciales para tu caso de uso

## Preguntas frecuentes

#### ¿Qué modelos admiten pronunciación basada en fonemas?

Las etiquetas de fonemas de los diccionarios de pronunciación solo funcionan con los modelos eleven_v4, eleven_flash_v2 y eleven_v3.

Otros modelos omiten las etiquetas de fonemas del diccionario y usan la pronunciación predeterminada. Para otros modelos,
usa etiquetas de alias para sustituir grafías o frases que produzcan la pronunciación que
necesitas.

Si quieres usar pronunciaciones IPA y CMU en idiomas distintos del inglés, tendrás que
cambiar al modelo eleven_v4 o eleven_v3.

#### ¿Puedo usar varios diccionarios?

Sí, puedes subir varios archivos de diccionario para gestionar distintos conjuntos de pronunciaciones.

#### ¿Qué ocurre si una palabra no está en el diccionario?

El modelo usará sus reglas de pronunciación predeterminadas para cualquier palabra que no se especifique en el
diccionario.

## Recursos adicionales

* [Clonar Voz Profesional](/docs/es/eleven-creative/voices/voice-cloning/professional-voice-cloning)
* [Diseño de Voz](/docs/es/eleven-creative/voices/voice-design)
* [Referencia de la API de Texto a Voz](/docs/es/api-reference/text-to-speech/convert)