Moknah 문서
무료로 시작하기
API 레퍼런스

음성 텍스트 변환 (STT) 전사

사전 녹음된 오디오 파일을 업로드하여 타임스탬프가 포함된 정확한 텍스트 전사를 비동기식으로 받아보세요.

대용량 오디오 파일은 처리하는 데 몇 분이 걸릴 수 있으므로 이 API는 안정적인 제출 및 폴링(Submit & Poll) 아키텍처를 사용합니다. 먼저 파일을 제출하여 job_id를 받은 다음, 전사가 완료될 때까지 상태 엔드포인트를 폴링합니다.

1. 오디오 작업 제출

POST /api/v1/stt/submit/
매개변수 필수 유형 설명
audio 필수 file 전사할 오디오 파일입니다. mp3, wav, m4a 등을 지원합니다. 최대 50MB.
language 선택 string 기본값은 ar-JO입니다.
output_format 선택 string json 또는 srt를 허용합니다. 기본값은 json입니다.

2. 작업 상태 확인

GET /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("\n전사 완료!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\n작업 실패:", result)
        break
API 지원

API 관련 질문이나 문제는 다음 주소로 문의해 주세요: api@moknah.io.