# Yandex SpeechKit API: POST /speech/stt/v2/longRunningRecognize — Асинхронное распознавание

Хост `transcribe.api.cloud.yandex.net`. Возвращает ID операции; результат хранится 3 дня.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `config.specification.languageCode` | body | string | нет | Язык, по умолчанию ru-RU |
| `config.specification.model` | body | string | нет | Модель, по умолчанию general; влияет на стоимость |
| `config.specification.profanityFilter` | body | boolean | нет | Маскировать ненормативную лексику |
| `config.specification.literature_text` | body | boolean | нет | Режим нормализации текста |
| `config.specification.audioEncoding` | body | string | нет | LINEAR16_PCM, OGG_OPUS (по умолчанию) или MP3 |
| `config.specification.sampleRateHertz` | body | integer | нет | 48000 (по умолчанию), 16000, 8000; обязателен для LINEAR16_PCM |
| `config.specification.audioChannelCount` | body | integer | нет | Число каналов, только для LPCM, по умолчанию 1 |
| `config.specification.rawResults` | body | boolean | нет | Числа прописью |
| `audio.uri` | body | string | да | Ссылка на файл в Yandex Object Storage |

## Базовые 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/rasshifrovat-dlinnuyu-zapis-razgovora.md)

---

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