AI
Node.js에서 VITO 음성인식 API 사용하기 (with TypeScript)
두줄요약
TypeScript 기반 Express 서버에서 VITO 파일·스트리밍 STT API 연동 방법을 안내했습니다. 파일 전사 polling과 WebSocket 청크 전송, 결과 반환 흐름을 다뤘습니다.
구조와 흐름
- Express·TypeScript 프로젝트 구성과 환경 변수 기반 VITO API 인증 토큰 관리
- 파일 STT 요청 후 전사 ID 수신, polling으로 완료 상태와 발화 텍스트 조회
- WebSocket 스트리밍 STT 연결 후 파일 청크 전송,
EOS전달, 최종 인식 결과 수집
적용해볼 점
- Multer 기반 파일 업로드 라우트로 일반 STT와 스트리밍 STT 엔드포인트 분리
- 파일 STT 설정의 화자 분리·문장부호 변환·비문 필터와 스트리밍 설정의 샘플 레이트·인코딩 지정
- 토큰 발급 실패, 파일 누락, 전사 실패, WebSocket 오류에 대한 HTTP·Promise 오류 처리
주의할 점
- 파일 STT 결과 조회 시 완료·실패 상태에 따른 polling 해제 필요
- VITO Secret은 발급 화면에서만 확인 가능하므로 별도 보관 및
.env관리 필요