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://aistudio.yandex.ru/ru/docs/speechkit/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-speechkit.md