Справочник по 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.