Relay Live Translate
Gemini Live로 말을 실시간 번역하고, 원문과 번역을 세션별로 Supabase에 저장하는 웹앱입니다. 미국 출장에 쓰려고 혼자 만든 개인 프로젝트입니다.
분당 비용 상한
$0.037
토큰 단가로 계산한 추정치
개발 기간
8일
커밋 22개, 2026-07-03 ~ 07-10
내가 한 일
- 기획부터 개발까지 혼자 했고, AI 코딩 에이전트를 구현 파트너로 썼습니다.
- 예전 한 파일짜리 앱을 상태 머신, 저장소, 라우터, 번역 엔진으로 나눠 다시 만들었습니다.
- Supabase로 Google 로그인과 세션 저장을 붙이고, 행 단위 보안(RLS)으로 각자 자기 기록만 보게 했습니다.
문제
미국 출장에서 영어 대화를 실시간으로 이해하고, 나중에 다시 볼 수 있게 원문과 번역을 남길 도구가 필요했습니다.
만든 것
- 마이크나 공유한 브라우저 탭의 소리를 16kHz PCM으로 Gemini Live에 보내고, 번역된 음성(24kHz)과 자막을 받아 재생합니다.
- 원문과 번역을 세션별로 저장합니다. 먼저 브라우저에 저장한 뒤 Supabase로 동기화하고, Supabase가 없어도 로컬 모드로 동작합니다.
- Supabase에는 세션과 문단 테이블 두 개가 있고, 행 단위 보안 정책으로 자기 세션과 그 문단만 읽고 쓸 수 있습니다. 익명 접근은 막았습니다.
- 세션마다 예상 비용을 보여 주고, 기록을 TXT로 내보냅니다.
시행착오
- 끝나지 않는 문단: 모델이 발화 종료 신호를 보내지 않아서, 텍스트가 2.5초 동안 멈추면 문단을 확정합니다. 음성은 텍스트보다 몇 초 늦게 오기 때문에 음성이 타이머를 다시 켜지 않게 했습니다.
- 유령 재연결: 연결이 닫히면 0.6초 뒤 다시 붙는데, 그사이 사용자가 멈추거나 언어를 바꾸면 엉뚱한 세션이 살아났습니다. 시작·정지마다 세대 번호를 올리고, 같은 세대일 때만 다시 연결합니다. 언어를 바꾸면 이 경로로 새 언어 세션을 엽니다.
- 사라지는 기록: 동기화 큐가 전송 중에 새로 쌓인 작업을 버리는 버그를 포함해, 리뷰에서 실제 버그 3개를 찾아 고쳤습니다. 실패한 작업은 따로 모아 두고, 다시 온라인이 되면 재시도합니다.
- 로그인과 라우터 충돌: 해시 라우터(
#/)와 OAuth 콜백이 부딪혀서, 콜백이 쿼리 문자열로 오는 PKCE 방식을 썼습니다. 로그인도 이메일 OTP에서 Google 로그인으로 바꿨습니다. - 느린 CDN: Supabase 클라이언트를 필요할 때 불러오게 해서, CDN이 느려도 번역과 로컬 저장은 막히지 않습니다.
- 키 노출: 클라이언트에 둔 Gemini 키는 누구나 볼 수 있어서, 서버에 올릴 때는 Cloudflare Access 뒤에만 두도록 정했습니다. Supabase에는 공개용 키만 둡니다.
품질
- Node 기본 테스트 러너로 단위 테스트 27개(헬퍼, 저장소, 동기화)를 돌립니다.
- 비용은 토큰 단가로 계산해 분당 최대 약 $0.037이고, 말하는 시간이 절반이면 약 $0.021입니다.