[Документация Yandex Cloud](../../index.md) > [speechkit](../index.md) > [Распознавание речи](index.md) > Нормализация результатов распознавания

# Нормализация результатов распознавания

Нормализация — это преобразование (постобработка) текста, полученного в результате работы модели распознавания речи Yandex SpeechKit. Нормализация выполняется согласно параметрам, указанным в запросах API.

{% note info %}

В режиме автоматического распознавания языка ([код языка](models.md#languages) `auto`) нормализация не выполняется.

{% endnote %}

Вы можете применять следующие уровни нормализации:

* Представление дат и времени в цифровом формате.
* Преобразование чисел из словарного в цифровой формат.
* Добавление заглавной буквы в начале предложения и в именах собственных.
* Маскирование обсценной лексики.
* Форматирование телефонных номеров. Например, `7(999)123-45-67` вместо `7 999 123 45 67`.
* Добавление знаков пунктуации.

{% note warning %}

Правила представления нормализованного текста могут меняться. Учитывайте это при интеграции и следите за [обновлениями](../release-notes-stt.md).

{% endnote %}


## Управление параметрами нормализации {#control}


{% note info %}

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

{% endnote %}


### API v1 {#api-v1}

* [REST API v1 для синхронного распознавания](api/request-api.md).

| Уровень нормализации | Параметр API |
| :----- | :------|
| Маскирование обсценной лексики | `profanityFilter=true` |
| Преобразование чисел из словарного в цифровой формат | По умолчанию включено. Чтобы отключить, укажите `rawResults=true` |

### API v2 {#api-v2}

* [gRPC API v2 для потокового распознавания](api/streaming-api.md).

| Уровень нормализации | Параметр API |
| :----- | :------|
| Маскирование обсценной лексики | `config.specification.profanityFilter=true` |
| Преобразование чисел из словарного в цифровой формат | По умолчанию включено. Чтобы отключить, укажите `config.specification.rawResults=true` |

* [REST API v2 для асинхронного распознавания](api/transcribation-api.md).

| Уровень нормализации | Параметр API |
| :----- | :------|
| Маскирование обсценной лексики | `config.specification.profanityFilter=true` |
| Преобразование чисел из словарного в цифровой формат | По умолчанию включено. Чтобы отключить, укажите `config.specification.rawResults=true` |
| Добавление заглавной буквы в начале предложения и в именах собственных. Добавление знаков пунктуации | `config.specification.literature_text=true` |

### API v3 {#api-v3}

Для включения нормализации задайте в [API](../stt-v3/api-ref/grpc/Recognizer/index.md) параметр `text_normalization=TEXT_NORMALIZATION_ENABLED`. Некоторые опции включаются дополнительными параметрами, когда задан `text_normalization=TEXT_NORMALIZATION_ENABLED`.

| Уровень нормализации | Параметр API |
| :----- | :------|
| Представление дат и времени в цифровом формате | `text_normalization=TEXT_NORMALIZATION_ENABLED` |
| Преобразование чисел из словарного в цифровой формат | `text_normalization=TEXT_NORMALIZATION_ENABLED` |
| Форматирование телефонных номеров | `text_normalization=TEXT_NORMALIZATION_ENABLED`. Чтобы выключить только этот уровень, укажите дополнительно `phone_formatting_mode=PHONE_FORMATTING_MODE_DISABLED`. |
| Маскирование обсценной лексики | `profanity_filter=true` при включенном параметре `text_normalization` |
| Добавление заглавной буквы в начале предложения и в именах собственных. Добавление знаков пунктуации | `literature_text=true` при включенном параметре `text_normalization` |