Moknah Документы
Начать бесплатно
Справочник по API

Транскрибация речи в текст (STT)

Загружайте предварительно записанные аудиофайлы для точной текстовой расшифровки с временными метками в асинхронном режиме.

Поскольку обработка больших аудиофайлов может занимать несколько минут, данный API использует надежную архитектуру «отправка и опрос» (Submit & Poll). Сначала вы отправляете файл и получаете идентификатор задачи (job_id), а затем периодически опрашиваете конечную точку статуса до тех пор, пока транскрибация не завершится.

1. Отправить аудиозадание

ПУБЛИКАЦИЯ /api/v1/stt/submit/
Параметр Обязательно Тип Описание
audio обязательный файл Аудиофайл для транскрибации. Поддерживаются форматы mp3, wav, m4a и др. Максимальный размер — 50 МБ.
language по выбору строка Значение по умолчанию — ar-JO.
output_format по выбору строка Принимает json или srt. По умолчанию — json.

2. Проверить статус задачи

ПОЛУЧИТЬ /api/v1/stt/status/{job_id}/

Пример интеграции для промышленной эксплуатации (Python)

import requests
import time

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Отправьте аудиофайл
submit_url = "https://moknah.io/api/v1/stt/submit/"
files = {"audio": ("audio.mp3", open("long_audio.mp3", "rb"), "audio/mpeg")}
data = {"language": "ar-JO", "output_format": "json"}

print("Отправка аудио...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Задача поставлена в очередь! ID: {job_id}")

# 2. Опрос для получения результата
status_url = f"https://moknah.io/api/v1/stt/status/{job_id}/"

while True:
    res = requests.get(status_url, headers=HEADERS)
    result = res.json()

    if result.get("status") in ["queued", "processing"]:
        print("Обработка... повторная проверка через 5 секунд.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("Расшифровка завершена!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nСбой задания:", result)
        break
Поддержка API

По вопросам или проблемам, связанным с API, обращайтесь к нам по адресу api@moknah.io.