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.