Moknah Dokumentacja
Zacznij za darmo
Dokumentacja API

Transkrypcja mowy na tekst (STT)

Przesyłaj nagrane wcześniej pliki audio, aby asynchronicznie otrzymać dokładną transkrypcję tekstu ze znacznikami czasu.

Ponieważ przetwarzanie dużych plików audio może potrwać kilka minut, to API wykorzystuje niezawodną architekturę „Submit & Poll” (wyślij i odpytuj). Najpierw przesyłasz plik, aby otrzymać identyfikator job_id, a następnie odpytujesz punkt końcowy statusu, aż transkrypcja zostanie zakończona.

1. Prześlij zadanie audio

POST /api/v1/stt/submit/
Parametr Wymagane Typ Opis
audio wymagane file Plik audio do transkrypcji. Obsługuje formaty mp3, wav, m4a itp. Maks. 50 MB.
language opcjonalne string Domyślnie ar-JO.
output_format opcjonalne string Akceptuje json lub srt. Domyślnie json.

2. Sprawdź status zadania

GET /api/v1/stt/status/{job_id}/

Przykład integracji produkcyjnej (Python)

import requests
import time

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

# 1. Prześlij plik audio
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("Przesyłanie audio...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Zadanie w kolejce! ID: {job_id}")

# 2. Odpytuj o wynik
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("Przetwarzanie... ponowne sprawdzenie za 5 sekund.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("\nTranskrypcja zakończona!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nZadanie nie powiodło się:", result)
        break
Wsparcie API

W razie pytań lub problemów związanych z API skontaktuj się z nami pod adresem api@moknah.io.