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

# Dicionários de pronúncia

## Visão geral

Os dicionários de pronúncia permitem personalizar como seu agente de IA pronuncia palavras ou frases específicas. Isso é especialmente útil para:

* Corrigir a pronúncia de nomes, lugares ou termos técnicos
* Garantir uma pronúncia consistente entre conversas
* Personalizar variações regionais de pronúncia

## Configuração

> **Note**
>
> As tags de fonemas do dicionário de pronúncia funcionam apenas com os modelos eleven_v4, eleven_flash_v2 e eleven_v3.
>
> Outros modelos ignoram as tags de fonemas do dicionário e usam a pronúncia padrão. Para outros modelos, use
> as tags de alias para substituir grafias ou frases que produzam a pronúncia necessária.
>
> Se quiser usar pronúncias IPA e CMU em idiomas que não sejam inglês, você precisará
> mudar para os modelos eleven_v3 ou eleven_v4.

### Anexe um dicionário ao seu agente

#### Atualizar pelo dashboard

Abra seu agente no dashboard, acesse **Configurações de voz** e adicione um dicionário de pronúncia. Salve as alterações.

![Adicione um dicionário de pronúncia nas configurações de voz do agente](/docs/_fern-img/1e7c851096776b9b8cb39cc95b54d394cc02ec7e4771d13958a259accf0ad757.webp)

#### Atualizar pela CLI

#### Baixe a configuração do agente

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

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

Defina `conversation_config.tts.pronunciation_dictionary_locators`:

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

#### Envie suas alterações

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

#### Atualizar pela 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 do arquivo de dicionário

Os dicionários de pronúncia usam arquivos `.pls` baseados em XML. Veja um exemplo de estrutura:

```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 compatíveis

Os dicionários de pronúncia aceitam dois tipos de notação de pronúncia:

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

   * Controle mais preciso da pronúncia
   * Requer conhecimento dos símbolos IPA
   * Exemplo: "nginx" como `/ˈɛndʒɪnˈɛks/`

2. **Formato de dicionário CMU (Carnegie Mellon University)**
   * Formato mais simples baseado em ASCII
   * Mais acessível para pronúncias em inglês
   * Exemplo: "tomato" como "T AH M EY T OW"

> **Tip**
>
> Você pode usar ferramentas de IA como Claude ou ChatGPT para ajudar a gerar notações IPA ou CMU para palavras
> específicas.

## Boas práticas

1. **Diferenciação entre maiúsculas e minúsculas**: Crie entradas separadas para versões em maiúsculas e minúsculas das palavras, se necessário
2. **Testes**: Sempre teste as pronúncias com a voz e o modelo escolhidos
3. **Manutenção**: Mantenha seu dicionário organizado e documentado
4. **Escopo**: Foque em palavras que são frequentemente pronunciadas incorretamente ou essenciais para seu caso de uso

## Perguntas frequentes

#### Quais modelos aceitam pronúncia baseada em fonemas?

As tags de fonemas do dicionário de pronúncia funcionam apenas com os modelos eleven_v4, eleven_flash_v2 e eleven_v3.

Outros modelos ignoram as tags de fonemas do dicionário e usam a pronúncia padrão. Para outros modelos,
use as tags de alias para substituir grafias ou frases que produzam a pronúncia
necessária.

Se quiser usar pronúncias IPA e CMU em idiomas que não sejam inglês, você precisará
mudar para o modelo eleven_v4 ou eleven_v3.

#### Posso usar vários dicionários?

Sim, você pode enviar vários arquivos de dicionário para lidar com diferentes conjuntos de pronúncias.

#### O que acontece se uma palavra não estiver no dicionário?

O modelo usará suas regras de pronúncia padrão para todas as palavras não especificadas no
dicionário.

## Recursos adicionais

* [Clonagem Profissional de Voz](/docs/pt/eleven-creative/voices/voice-cloning/professional-voice-cloning)
* [Design de Voz](/docs/pt/eleven-creative/voices/voice-design)
* [Referência da API de Text to Speech](/docs/pt/api-reference/text-to-speech/convert)