Moknah Dokumen
Mulai gratis
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.