Referensi API
Transkripsi Ucapan ke Teks (STT)
Unggah file audio rekaman untuk mendapatkan transkripsi teks yang akurat beserta stempel waktu secara asinkron.
Karena file audio berukuran besar dapat membutuhkan waktu beberapa menit untuk diproses, API ini menggunakan arsitektur Submit & Poll yang andal. Anda mengirimkan file terlebih dahulu untuk menerima job_id, lalu memeriksa endpoint status secara berkala hingga transkripsi selesai.
1. Kirim Tugas Audio
POST
/api/v1/stt/submit/
| Parameter | Wajib | Jenis | Deskripsi |
|---|---|---|---|
| audio | wajib | file | File audio yang akan ditranskripsi. Mendukung mp3, wav, m4a, dll. Maks. 50MB. |
| language | opsional | string | Defaultnya adalah ar-JO. |
| output_format | opsional | string | Menerima json atau srt. Defaultnya adalah json. |
2. Periksa Status Tugas
GET
/api/v1/stt/status/{job_id}/
Contoh Integrasi Produksi (Python)
import requests
import time
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1. Kirim file 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("Mengirim audio...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Tugas masuk antrean! ID: {job_id}")
# 2. Periksa hasilnya secara berkala
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("Memproses... memeriksa lagi dalam 5 detik.")
time.sleep(5)
elif result.get("status") == "completed":
print("\nTranskripsi Selesai!")
print(result["result"]["subtitles"])
break
else:
print("\nTugas Gagal:", result)
break
Dukungan API
Untuk pertanyaan atau masalah terkait API, hubungi kami di api@moknah.io.