Быстрый старт

Контракты повторяют Yandex SpeechKit: код, написанный под облако, заработает после смены адреса и ключа.

1. Получите ключ

Зарегистрируйтесь, затем в консоли откройте раздел «Ключи», создайте ключ и скопируйте секрет — он показывается один раз.

export SPEECHKIT_KEY=sk_...

2. Распознать запись

Ключ идёт заголовком Authorization: Api-Key …, звук — телом запроса. Адрес: https://speech.michill.ru/speech/v1/stt:recognize.

curl -X POST "https://speech.michill.ru/speech/v1/stt:recognize?format=wav&lang=sah-RU" \
  -H "Authorization: Api-Key $SPEECHKIT_KEY" \
  --data-binary @запись.wav

# {"result": "санаатыттан арахсан"}

3. Озвучить текст

HTTP v3: https://speech.michill.ru/tts/v3/utteranceSynthesis. Формат тела и параметры голоса — как в облачном API; голос задаётся именем из вашего аккаунта.

curl -X POST "https://speech.michill.ru/tts/v3/utteranceSynthesis" \
  -H "Authorization: Api-Key $SPEECHKIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Үтүө күнүнэн!"}' \
  -o ответ.json

Длинные записи

Всё, что длиннее лимита синхронного режима, разбирается очередью: /stt/v3/recognizeFileAsync возвращает операцию, состояние читается из /operations/<id>, результат — из /stt/v3/getRecognition.

gRPC

Потоковое распознавание и синтез доступны по gRPC v3 (speechkit.stt.v3.Recognizer, Synthesizer). Адрес gRPC-эндпоинта и пример на Python с официальным клиентом — в консоли, раздел «Как подключить» (после входа).

Что дальше