# Aktualizacja ElevenLabs: Przegląd nowych narzędzi i zarządzania głosem

> Kompletny przewodnik po generowaniu mowy w ElevenLabs: przegląd modeli (v3, Multilingual v2, Flash, Turbo), tagi audio do intonacji, fonemy IPA/Arpabet, słowniki PLS oraz zasady normalizacji tekstu.

Najnowsze aktualizacje platformy ElevenLabs fundamentalnie rozszerzyły możliwości sztucznej inteligencji w zakresie syntezy mowy ludzkiej. Deweloperzy otrzymali zróżnicowaną linię modeli: od ultrarealistycznego Eleven v3 z obsługą subtelnych przejść emocjonalnych, po ultra-szybkie Flash i Turbo przeznaczone do scenariuszy strumieniowych w czasie rzeczywistym.

W tym praktycznym przewodniku omówiono wszystkie kluczowe narzędzia i metody pracy z głosem: wybór architektury, zarządzanie tagami audio-emocji, precyzyjne strojenie tempa za pomocą SSML, pracę z międzynarodowymi słownikami fonetycznymi (PLS) oraz obowiązkową normalizację tekstu przed wysłaniem do API.

---

## 1. Przegląd modeli linii ElevenLabs

Współczesny ekosystem ElevenLabs oferuje cztery kluczowe modele syntezy mowy, zoptymalizowane pod kątem różnych wymagań inżynierskich.

### 1.1. Cechy architektoniczne i przeznaczenie modeli

- **Eleven v3 (alpha):** model flagowy o najwyższej jakości i naturalności mowy. Główną przewagą jest natywne wsparcie dla tagów dźwiękowych służących do wyrażania emocji (radość, smutek, szept, krzyk, westchnienie). Najlepiej zoptymalizowany dla treści anglojęzycznych i wymagający dłuższych, kontekstowo bogatych promptów.
- **Multilingual v2:** „złoty standard” dla produktów globalnych. Obsługuje ponad 30 języków (w tym polski z wysoką dokładnością akcentów i diakrytyki). Zapewnia stabilną wymowę złożonych zdań, choć dysponuje mniej dramatycznym zakresem modulacji emocjonalnych niż v3.
- **Flash v2.5:** model wysokiej prędkości o niskim opóźnieniu (latency ~75 ms) i limicie do 5 000 znaków na jedno żądanie. Optymalny balans między jakością brzmienia a szybkością dla interaktywnych asystentów.
- **Turbo v2.5:** ekstremalnie szybki model do scenariuszy, gdzie opóźnienie jest krytycznym czynnikiem (telefoniczne boty głosowe, synchroniczne tłumaczenie streamów). Ofiarowuje mikrointonacje na rzecz natychmiastowej odpowiedzi.

### 1.2. Zbiorcza tabela porównawcza cech

| Model | Jakość i ekspresja | Szybkość generowania | Obsługa języków | Limit znaków | Optymalne zastosowanie |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **Eleven v3 (alpha)** | Maksymalna, żywa emocjonalność | Umiarkowana | Angielski (inne eksperymentalnie) | 15 000 | Podcasty, audiobooki, dubbing filmowy, dialogi fabularne |
| **Multilingual v2** | Wysoka, stabilna | Średnia | 30+ języków (w tym polski) | 15 000 | Lokalizacja wielojęzyczna, wideo korporacyjne, asystenci |
| **Flash v2.5** | Dobra (zbalansowana) | Bardzo wysoka | Angielski, częściowo inne | 5 000 | Chatboty, streaming, NPC w grach, tłumaczenie na żywo |
| **Turbo v2.5** | Podstawowa użytkowa | Maksymalna (~50 ms) | Podstawowy zestaw języków | 5 000 | Systemy IVR, powiadomienia awaryjne, boty wysokiego obciążenia |

---

## 2. Kryteria wyboru modelu pod scenariusz

Wybór modelu determinowany jest balansem między dopuszczalnym opóźnieniem (latency), kosztem generowania a wymaganiami dotyczącymi emocjonalności.

### 2.1. Kreatywne dubbingowanie vs. streaming w czasie rzeczywistym

:::tabs
=== Kreatywne dubbingowanie (v3)
Dla artystycznych audiobooków, dubbingu zwiastunów czy reklam wybieraj **Eleven v3**. Jest zdolna generować dramatyczne pauzy, przydechy, śmiech i zmiany nastroju wewnątrz jednego akapitu, tworząc pełną iluzję żywego aktora.
=== Wielojęzyczność (Multilingual v2)
Jeśli Twój projekt skierowany jest do międzynarodowej publiczności lub zawiera teksty wielojęzyczne, jednoznaczny wybór to **Multilingual v2**. Nie cierpi na błędy fonetyczne przy przejściu między alfabetem łacińskim a innymi systemami pisma i poprawnie odwzorowuje nazwy lokalne.
=== Czas rzeczywisty (Flash / Turbo)
Dla interfejsów głosowych, obsługi klienta telefonicznej lub interaktywnych NPC w grach używaj **Flash v2.5** lub **Turbo v2.5**. Zapewniają one bezszwowy dialog bez nieprzyjemnych pauz między pytaniem użytkownika a odpowiedzią systemu.
:::

### 2.2. Wielojęzyczna lokalizacja i synteza w czasie rzeczywistym

> [!TIP]
> Dla dużych serwisów najefektywniejsza jest hybrydowa architektura: pierwsze frazy powitalne dla użytkownika generowane są przez ultraszybki **Flash v2.5**, a długie, rozbudowane informacje – przez **Multilingual v2**.

---

## 3. Zarządzanie intonacją, emocjami i tagami audio

Główny przełom nowych wersji ElevenLabs to możliwość sterowania mannerem mówienia bezpośrednio poprzez znaczniki w tekście.

### 3.1. Możliwości modelu Eleven v3 i tagi dźwiękowe

Model Eleven v3 rozpoznaje wbudowane tagi audio, które działają jak didaskalia dla lektora:

- **Stany emocjonalne:** `<happy>`, `<sad>`, `<angry>`, `<excited>`, `<calm>`, `<sarcastic>`.
- **Efekty dźwiękowe i reakcje:** `<laugh>`, `<sigh>`, `<cough>`, `<gasp>`, `<whisper>`, `<shout>`.
- **Przejścia stylistyczne:** opakowanie pojedynczych replik pozwala zmieniać nastrój postaci w czasie rzeczywistym.

### 3.2. Wpływ interpunkcji, rejestru i przerw na melodykę

Poza jawnymi tagami, sieć neuronowa reaguje wrażliwie na standardową interpunkcję tekstową:
- **Kropka (`.`):** pełnoprawna pauza z opadającą intonacją zakończonej myśli.
- **Przecinek (`,`):** krótka rytmiczna zwłoka z zachowaniem podwyższonego tonu.
- **Myślnik (`—`) lub trzy kropki (`...`):** tworzą efekt naturalnego wahania lub zadumy narratora.
- **WIELKIE LITERY:** zmuszają model do wyróżnienia kluczowego słowa akcentem i głośnością.

---

## 4. Praktyczne przykłady intonacji i dialogów

Rozważmy prawidłowe użycie tagów na konkretnych szablonach tekstowych.

### 4.1. Scenariusze monologu, dialogu i przejść emocjonalnych

> 💡 **Przykład monologu z tagami audio:**
```text
<laugh> It’s funny how life works sometimes. You think you’ve planned everything perfectly... but then <sigh> something unexpected happens.
```
*Wynik: model zaczyna mowę od naturalnego krótkiego śmiechu, robi wyraźną pauzę na trzech kropkach i wypuszcza powietrze przed słowem „something”.*

> 💡 **Przykład dramatycznego dialogu dwóch postaci:**
```text
<angry> "I told you never to open that door!" </angry>
<calm> "I know, but you don't understand what was inside..." </calm>
```
*Wynik: pierwsza replika brzmi głośno i agresywnie, a odpowiedź – stonowanym, uspokajającym tonem.*

### 4.2. Rekomendacje: stabilność generowania, dobór głosu i balans tagów

1. **Długość kontekstu:** unikaj promptów składających się z 1–2 słów. Dla stabilnego generowania przekazuj frazy o długości minimum 10 słów.
2. **Kompatybilność akustyczna głosu:** nie wszystkie sklonowane głosy reagują jednakowo dobrze na tag `<shout>` czy `<whisper>`. Testuj prompt na 2–3 lektorach z biblioteki VoiceLab.
3. **Umiarkowanie w tagach:** nie łącz więcej niż trzech efektów w jednym zdaniu, aby uniknąć artefaktów zniekształcenia dźwięku.

---

## 5. Zarządzanie tempem, pauzami i szybkością mowy

Do precyzyjnej synchronizacji mowy z obrazem wideo lub animacją stosuje się dokładne opóźnienia i systemowe parametry szybkości.

### 5.1. Tagi SSML pauz i opóźnienia interpunkcyjne

Do ustawiania dokładnego czasu trwania ciszy wykorzystywany jest tag SSML przerwy:

```xml
Hello there <break time="1.5s" /> welcome to our system.
```

- Wspierane wartości w sekundach (`1.5s`) lub milisekundach (`500ms`).
- Zakres czasu trwania jednej pauzy zazwyczaj wynosi od `0.1s` do `3.0s`.

### 5.2. Parametr szybkości mowy (speed) w API

Szybkość generowania definiowana jest w konfiguracji żądania poprzez parametr `speed`:
- `1.0` – referencyjna prędkość wybranego lektora.
- `0.8` – spokojne, umiarkowane tempo do medytacji lub materiałów edukacyjnych.
- `1.2` – energiczna, dynamiczna prezentacja do reklam i przeglądów wiadomości.
- Dopuszczalny zakres roboczy: od `0.5` do `2.0`.

---

## 6. Zarządzanie wymową: fonemy, tagi alias i słowniki PLS

Gdy model napotyka specyficzne terminy medyczne, akronimy lub rzadkie imiona, z pomocą przychodzą reguły fonetyczne.

### 6.1. Znaczniki fonetyczne (IPA / CMU Arpabet) i tagi alias

Za pomocą tagu `<phoneme>` można ustawić dokładną transkrypcję słowa według Międzynarodowego Alfabetu Fonetycznego IPA:

```xml
<phoneme alphabet="ipa" ph="həˈləʊ">hello</phoneme>
```

Dla prostych skrótów wygodne jest używanie pseudonimów poprzez tag `<alias>`:

```xml
<alias text="laugh out loud">LOL</alias>
```
*Model wypowiedzi pełną rozwiniętą frazę zamiast niezrozumiałego akronimu.*

### 6.2. Korporacyjne słowniki wymowy (PLS)

Dla dużych projektów ElevenLabs wspiera standard **Pronunciation Lexicon Specification (PLS)**. Możesz przesłać plik XML słownika do ustawień obszaru roboczego (Workspace), a wszystkie głosy systemu będą automatycznie wymawiać nazwy marek i produktów zgodnie z Twoim standardem korporacyjnym.

### 6.3. Triki kontekstowe i prezentacja dialogowa

> [!NOTE]
> Jeśli nie chcesz przeciążać tekstu tagami XML, użyj transliteracji fonetycznej: napisz trudne słowo sylabami (np. *"Ne-o-bank"* zamiast *"Neobank"*).

---

## 7. Normalizacja tekstu: liczby, daty, waluty i skróty

Sieci neuronowe konwertują symbole na dźwięk sekwencyjnie. Nieprzygotowany tekst często prowadzi do tego, że data `11/05` brzmi jak „jedenaście dzielone przez pięć”.

### 7.1. Dlaczego modele popełniają błędy w liczbach i znakach specjalnych

Modele Text-to-Speech nie zawsze mogą automatycznie określić kontekst: czy liczba `1984` to rok, kwota w złotych, numer mieszkania czy kod telefoniczny.

### 7.2. Trzy metody normalizacji: wybór modelu, prompting i RegEx

1. **Wybór modelu adaptacyjnego:** Multilingual v2 ma wbudowane zasady lepszej normalizacji liczb niż eksperymentalne v3.
2. **Werbalizacja w prompcie:** pisz liczby słowami bezpośrednio w tekście źródłowym.
3. **Programowe preprocesowanie (RegEx):** przed wywołaniem API wyrażenia regularne zastępują znaki walut i formaty dat ich odpowiednikami słownymi.

### 7.3. Tabela referencyjna normalizacji danych liczbowych i tekstowych

| Kategoria | Nieprzygotowane wejście | Znormalizowany tekst dla API |
| :--- | :--- | :--- |
| **Numer telefonu** | `+48 50 123 45 67` | `plus czterdzieści osiem, pięćdziesiąt, sto dwadzieścia trzy, czterdzieści pięć, sześćdziesiąt siedem` |
| **Data kalendarzowa** | `24.08.1991` | `dwudziestego czwartego sierpnia tysiąc dziewięćset dziewięćdziesiątego pierwszego roku` |
| **Waluta** | `$250` | `dwieście pięćdziesiąt dolarów` (lub `two hundred and fifty dollars`) |
| **Zakres** | `10-15 kg` | `od dziesięciu do piętnastu kilogramów` |
| **Akronim** | `NASA` | `NASA` (jako słowo) lub `E-N-A-S-A` (przez dywizy, jeśli potrzebne litery) |

---

## 8. Integracja przez API i przykłady implementacji

Dla niezawodnej syntezy po stronie serwera należy obligatoryjnie wysyłać wcześniej znormalizowany tekst ze wskazaniem parametrów stabilności głosu.

### 8.1. Formułowanie żądania ze znormalizowanym tekstem

> [!IMPORTANT]
> Parametry `stability` (stabilność) oraz `similarity_boost` (podobieństwo) regulują zmienność: zapewnij stabilne wartości dla spójnego brzmienia.