Web Translator API - 브라우저에서 로컬 번역하기

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

• *웹 개발자 및 AI 활용 앱 개발자**
• 난이도: 중급 (브라우저 API 활용 및 AI 모델 이해 필요)*

핵심 요약

• Translator API는 크롬 138+에서 사용 가능한 실험적 웹 API로, AI 기반 로컬 번역 기능 제공
• 주요 메서드: translate() (일반 문자열 번역), translateStreaming() (스트림 방식 번역)
• 호환성 제한: 현재 크롬만 지원, Mozilla는 지원 예정 없음

섹션별 세부 요약

1. API 개요

• 실험적 기능: 브라우저 내부 AI 모델을 활용한 로컬 번역 지원
• 호환성: 크롬 138 이상에서만 작동, 프로덕션 사용 시 호환성 테이블 확인 필요
• 기능 범위: sourceLanguage, targetLanguage 속성으로 언어 설정, inputQuota로 쿼터 사용량 관리

2. 사용 방법

• 인스턴스 생성: await Translator.create({sourceLanguage: "en", targetLanguage: "ko"})
• 번역 실행:

```javascript

const result = await translator.translate(myTextString);

```

• 스트림 방식:

```javascript

const stream = translator.translateStreaming(myTextString);

for await (const chunk of stream) { console.log(chunk); }

```

3. 제한사항

• 브라우저 지원: 크롬만 지원, Mozilla는 PR 진행 중이지만 이슈로 인해 지원 어려움
• 인증 절차: 이메일 인증 후 사용 가능 (문서 내 "인증 이메일 클릭후..." 문구 참고)

결론

• 현재는 실험적 기능이므로, 프로덕션 환경에서는 호환성 검증 필수
• 크롬 138+에서만 작동하므로, 타 브라우저 지원 필요 시 대체 방안 검토 필요
• 예제 코드를 기반으로 스트림 방식 번역이 유용한 시나리오에 적합함