# Yandex SpeechKit API: POST /speech/v1/stt:recognize — Синхронное распознавание

Тело — двоичное содержимое аудиофайла: до 1 МБ, до 30 секунд, один канал.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `lang` | query | string | нет | Язык распознавания, по умолчанию ru-RU |
| `topic` | query | string | нет | Языковая модель, по умолчанию general |
| `profanityFilter` | query | boolean | нет | Исключать ненормативную лексику, по умолчанию false |
| `rawResults` | query | boolean | нет | Числа прописью (true) или цифрами (false, по умолчанию) |
| `format` | query | string | нет | lpcm (без WAV-заголовка) или oggopus (по умолчанию) |
| `sampleRateHertz` | query | integer | нет | 48000 (по умолчанию), 16000 или 8000; только для lpcm |
| `folderId` | query | string | нет | ID каталога (для пользовательского аккаунта) |

Пример ответа:

```json
HTTP/1.1 200 OK
YaCloud-Billing-Units: 15
{
  "result": "твой номер 212-85-06"
}
```

## Базовые URL

- Синхронное распознавание: `https://stt.api.cloud.yandex.net`
- Асинхронное распознавание: `https://transcribe.api.cloud.yandex.net`
- Синтез речи: `https://tts.api.cloud.yandex.net`
- Операции: `https://operation.api.cloud.yandex.net`

## Авторизация

Тип: Bearer-токен

- IAM-токен: `Authorization: Bearer <IAM-токен>`
- API-ключ сервисного аккаунта: `Authorization: Api-Key <API-ключ>`

При авторизации пользовательским аккаунтом нужен параметр `folderId`; для сервисного аккаунта он не используется. Асинхронное распознавание доступно только сервисным аккаунтам (роли `ai.speechkit-stt.user` и `storage.uploader`).

## Нюансы

- Число тарифицируемых единиц возвращается в заголовке ответа `YaCloud-Billing-Units`.
- Для `lpcm` передаётся «сырое» аудио без WAV-заголовка; частота задаётся явно.
- Для OggOpus и MP3 число каналов не указывается — оно есть в самом файле.
- Для асинхронного распознавания файл сначала загружают в бакет Object Storage.

## Сценарии с этим методом

- [Распознать короткое голосовое сообщение](https://mcp-everything.ru/integrations/yandex-speechkit/scenarios/raspoznat-korotkoe-golosovoe-soobschenie.md)

---

Если этого недостаточно — официальная документация: https://aistudio.yandex.ru/ru/docs/speechkit/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-speechkit.md