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.