← 목록으로: SERVICE

Relay Live Translate

Gemini Live로 말을 실시간 번역하고, 원문과 번역을 세션별로 Supabase에 저장하는 웹앱입니다. 미국 출장에 쓰려고 혼자 만든 개인 프로젝트입니다.

기술
JavaScript, Gemini Live API, Web Audio API, Supabase, PostgreSQL, Google OAuth, Node.js test runner
분당 비용 상한

$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입니다.