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

# Słowniki wymowy

## Omówienie

Słowniki wymowy pozwalają dostosować sposób, w jaki agent AI wymawia określone słowa lub frazy. Jest to szczególnie przydatne do:

* Korygowania wymowy nazw, miejsc lub terminów technicznych
* Zapewnienia spójnej wymowy w rozmowach
* Dostosowania regionalnych wariantów wymowy

## Konfiguracja

> **Note**
>
> Tagi fonemów w słowniku wymowy działają tylko z modelami eleven_v4, eleven_flash_v2 i eleven_v3.
>
> Inne modele pomijają tagi fonemów ze słownika i używają domyślnej wymowy. W przypadku innych modeli użyj
> zamiast nich tagów aliasów, aby zastąpić pisownię lub frazy takimi, które dają potrzebną wymowę.
>
> Jeśli chcesz używać wymowy IPA i CMU w językach innych niż angielski, musisz
> przełączyć się na modele eleven_v3 lub eleven_v4.

### Dołącz słownik do agenta

#### Aktualizacja w panelu

Otwórz agenta w panelu, przejdź do **Voice Settings** i dodaj słownik wymowy. Zapisz zmiany.

![Dodawanie słownika wymowy w ustawieniach głosu agenta](/docs/_fern-img/1e7c851096776b9b8cb39cc95b54d394cc02ec7e4771d13958a259accf0ad757.webp)

#### Aktualizacja przez CLI

#### Pobierz konfigurację agenta

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

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

Ustaw `conversation_config.tts.pronunciation_dictionary_locators`:

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

#### Wyślij zmiany

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

#### Aktualizacja przez 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>",
        },
      ],
    },
  },
});
```

## Format pliku słownika

Słowniki wymowy używają plików `.pls` opartych na XML. Oto przykładowa struktura:

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

## Obsługiwane formaty

Słowniki wymowy obsługują dwa rodzaje zapisu wymowy:

1. **IPA (międzynarodowy alfabet fonetyczny)**

   * Dokładniejsza kontrola nad wymową
   * Wymaga znajomości symboli IPA
   * Przykład: „nginx” jako `/ˈɛndʒɪnˈɛks/`

2. **Format słownika CMU (Carnegie Mellon University)**
   * Prostszy format oparty na ASCII
   * Bardziej przystępny dla angielskiej wymowy
   * Przykład: „tomato” jako „T AH M EY T OW”

> **Tip**
>
> Możesz użyć narzędzi AI, takich jak Claude lub ChatGPT, aby wygenerować zapis IPA lub CMU dla konkretnych
> słów.

## Dobre praktyki

1. **Wielkość liter**: W razie potrzeby utwórz osobne wpisy dla wersji słów pisanych wielką i małą literą
2. **Testowanie**: Zawsze testuj wymowę z wybranym głosem i modelem
3. **Utrzymanie**: Dbaj o porządek i dokumentację słownika
4. **Zakres**: Skup się na słowach, które są często błędnie wymawiane lub kluczowe dla twojego zastosowania

## FAQ

#### Które modele obsługują wymowę opartą na fonemach?

Tagi fonemów w słowniku wymowy działają tylko z modelami eleven_v4, eleven_flash_v2 i eleven_v3.

Inne modele pomijają tagi fonemów ze słownika i używają domyślnej wymowy. W przypadku innych modeli
użyj zamiast nich tagów aliasów, aby zastąpić pisownię lub frazy takimi, które dają potrzebną
wymowę.

Jeśli chcesz używać wymowy IPA i CMU w językach innych niż angielski, musisz
przełączyć się na model eleven_v4 lub eleven_v3.

#### Czy mogę używać wielu słowników?

Tak, możesz przesłać wiele plików słowników, aby obsługiwać różne zestawy wymowy.

#### Co się stanie, jeśli słowa nie ma w słowniku?

Model użyje domyślnych reguł wymowy dla każdego słowa, które nie zostało określone w
słowniku.

## Dodatkowe zasoby

* [Professional Voice Cloning](/docs/pl/eleven-creative/voices/voice-cloning/professional-voice-cloning)
* [Voice Design](/docs/pl/eleven-creative/voices/voice-design)
* [Dokumentacja API Text to Speech](/docs/pl/api-reference/text-to-speech/convert)