[Документация Yandex Cloud](../../../index.md) > [speechkit](../../index.md) > [Синтез речи](../index.md) > [Разметка текста](index.md) > TTS-разметка

# TTS-разметка текста


{% note info %}

В [регионе Казахстан](../../../overview/concepts/region.md) доступна только версия API v3.

{% endnote %}


TTS-разметка дает возможность управлять синтезом речи при помощи специальных символов и SIL-тегов. Это позволяет сделать синтезированную речь более естественной.

Поддержка TTS-разметки доступна для русского языка при использовании [API v3](../../tts-v3/api-ref/grpc/index.md) и [API v1](../request.md) для данных в формате `text`.

Расстановка пауз доступна для тестирования при синтезе на всех поддерживаемых языках.

{% note info %}

Сервис SpeechKit предназначен для синтеза естественной речи. Разметка данных для синтеза помогает настроить произношение отдельных слов, фраз и предложений, но не предназначена для генерации отдельных звуков и тишины.

Разметка в тексте будет служить подсказкой для синтеза, а не непосредственным указанием к действию.

{% endnote %}

## Элементы разметки {#markup-elements}

| Описание | Спецсимволы и теги |
|---|---|
| [Поставить ударение](#a) | `+` |
| [Явно указать паузу между предложениями](#pause) | `sil<[t]>`, где t — длительность паузы в миллисекундах. Максимальное значение — 7 000. |
| [Указать паузу, зависящую от контекста](#context-pause) | `<[small]>`. Допустимые значения: `tiny`, `small`, `medium`, `large`, `huge` |
| [Выделить акцент](#accent) | `<[accented]>` или `**акцентное слово**` |
| [Использовать фонетическое произношение](#phoneme) | `[[<фонемы_слова_разделенные_пробелами>]]` |

{% note warning %}

При [синтезе по аудиошаблонам](../templates.md) разметка за пределами переменной части игнорируется.

{% endnote %}

### Поставить ударение {#a}


Используйте символ `+` перед ударной гласной, в случаях, когда нужно уточнить корректный вариант произношения слова, например:

```text
Дверь в комнату заперта на зам+ок.
```

или

```text
Вход в з+амок действительно существовал.
```

### Явно указать паузу между предложениями {#pause}

Для явного указания паузы между предложениями вы можете добавить специальный тег: `sil<[t]>`, где t — длительность паузы в миллисекундах:

```text
Унылая пора! sil<[300]> Очей очарованье!
```

{% note info %}

Текст для синтеза не может состоять только из символов разметки. С помощью SpeechKit нельзя сгенерировать файл с тишиной вместо речи.

Паузы, поставленные в начале и в конце предложения, будут игнорироваться.

{% endnote %}

### Установить паузу, зависящую от контекста {#context-pause}

Используйте слова-подсказки, чтобы длительность пауз подбиралась автоматически.

```text
Мороз и солнце; <[medium]> день чудесный!
```

### Выделить акцент {#accent}


Чтобы выделить акцент в слове, можно поставить перед ним тег `<[accented]>`. Например:

```text
Удобные интерфейсы для решения <[accented]> задач.
```

Также выделить акцент на одном или нескольких словах можно при помощи звездочек (`**слово**`). Например:

```text
Мы всегда будем в ответе за тех, **кого приручили**.
```

### Использовать фонетическое произношение {#phoneme}

Используйте выделение блоком `[[ ]]`, чтобы контролировать правильность произношения с помощью фонем. Для воспроизведения будет использован текст в блоке:

```text
Привет! Меня зовут [[v a sʲ ʌ]]
```

[Список поддерживаемых фонем](tts-supported-phonemes.md).

### Примеры использования русских фонем {#rus-examples}

**Пример 1**

Ишимбай — город в России.

```text
Всем привет! Я взял билеты на автобус в город [[i ʂ ɨ m b a j]] и буду там наслаждаться природой.
```

**Пример 2**

Керемет — казахское женское имя. Возможна путаница `Керемет`/`керемёт`.

```text
Познакомься, это моя подруга [[kʲ ɪ rʲ ɪ mʲ ɛ t]]. Мы вместе учились в школе.
```

**Пример 3**

Лена — женское имя в родительном падеже, множественном числе. Возможна путаница `Лен`/`лён`.

```text
В моей семье очень много [[lʲ ɛ n]]. Это очень популярное имя у нас.
```

**Пример 4**

Берет — головной убор.  Возможна путаница `берет`/`берёт`.

```text
Голубой [[bʲ ɪ rʲ ɛ t]]. Передай мне, пожалуйста, мой берет.
```