Femoon/tts-azure-web

TTS Azure Web 是一个 Azure 文本转语音（TTS）网页应用，可以在本地或者云端使用你的 Azure Key 一键部署。TTS Azure Web is an Azure Text-to-Speech (TTS) web application. It allows you to run it locally or deploy it with a single click using your Azure Key.

TTS Azure Web – 빠른 개요

무엇인가요 – Microsoft Azure의 텍스트 음성 변환 서비스를 호출할 수 있는 가벼운 자체 호스팅 가능한 웹 UI입니다. 텍스트를 입력하거나 붙여넣고, 그래픽 인터페이스 또는 직접 SSML 마크업을 통해 음성 파라미터(언어, 스타일, 속도, 볼륨 등)를 조정하고, 생성된 오디오 파일을 다운로드할 수 있습니다.

왜 중요한가요 – Azure의 신경망 TTS는 고품질의 상용 음성 합성 엔진입니다. 이 프로젝트는 인증, API 호출, UI 구축에 필요한 반복 코드를 제거하여 개발자나 애호가가 로컬에서 또는 한 번의 클릭으로 Vercel에 배포하여 Azure TTS를 실험할 수 있도록 합니다.

핵심 기능 (README에 설명됨)

음성 커스터마이징 – 음성, 언어, 스타일, 캐릭터 선택.
오디오 컨트롤 – 속도, 억양, 볼륨 조정.
이중 모드 에디터 –
- 일반 모드: UI 슬라이더 및 드롭다운.
- SSML 모드: 세밀한 제어를 위한 음성 합성 마크업 언어(SSML) 직접 편집.
SSML 가져오기/내보내기 – 설정을 저장하고 나중에 다시 불러올 수 있음.
오디오 내보내기 – 생성된 음성을 오디오 파일로 다운로드.
상태 지속성 – Zustand와 지속성 미들웨어를 사용해 localStorage에 설정 저장.
국제화 – 영어 및 간체중국어 UI, 자동 로케일 감지.
반응형 디자인 – 데스크톱과 모바일 모두에서 작동.

기술 스택 (README에서)

계층	기술
프론트엔드 프레임워크	Next.js 15 (App Router)
UI 라이브러리	HeroUI (NextUI v2) + Tailwind CSS v4 + Framer Motion
언어	TypeScript (React 19)
상태 관리	Zustand + 지속성 미들웨어
국제화	Next.js 내장 i18n
음성 백엔드	Microsoft Azure Cognitive Services Speech SDK
패키징 / 배포	Docker, Vercel, 또는 일반 Node/Yarn

시작하기 (README 단계 요약)

Azure 자격 증명 획득 – Azure에서 Speech Service를 생성하고 SPEECH_KEY와 SPEECH_REGION를 기록.

리포지토리 루트에 .env.local 생성:

SPEECH_KEY=your_azure_key
SPEECH_REGION=your_azure_region
# 선택 사항
NEXT_PUBLIC_MAX_INPUT_LENGTH=4000
NEXT_TELEMETRY_DISABLED=1

종속성 설치 – 프로젝트는 Yarn Classic 사용:
```
npm i -g yarn   # 설치되지 않은 경우
yarn
```
로컬에서 실행 – 개발 서버 (localhost 전용):
```
yarn dev
# 또는 LAN에 공개
yarn lan-dev
```
http://localhost:3000 열기.
빌드 및 실행 – 프로덕션 준비 로컬 실행용:
```
yarn build
yarn start
```

배포 옵션

Vercel (한 번의 클릭) – README의 "Deploy with Vercel" 버튼 클릭; SPEECH_KEY와 SPEECH_REGION를 환경 변수로 제공.

Docker – 컨테이너 빌드 및 실행:

docker build -t tts-azure-web .
docker run -p 3000:3000 -e SPEECH_KEY=... -e SPEECH_REGION=... tts-azure-web

로컬 프로덕션 – 환경 변수 파일 설정 후 Yarn 빌드/스타트 명령어 사용.

일반적인 사용 사례

음성 기반 UI 컴포넌트의 빠른 프로토타이핑.
콘텐츠 제작 – 영상, 팟캐스트, 전자학습용 내레이션 또는 보이스오버 생성.
SSML 테스트 – 코드를 작성하지 않고 Azure의 SSML 기능 실험.
교육용 데모 – 강의나 워크숍에서 클라우드 기반 TTS의 작동 방식을 보여줌.

프로젝트 건강 및 유지보수

Linting & CI – ESLint (0경고 정책), Prettier, Husky 프리커밋 훅, Commitlint, Dependabot 보안 패치.
Node 버전 – Node 22+ 필요; Yarn 1.22.22.
라이선스 – MIT. 개인 및 상용 사용 모두 허용.

더 알아보기

라이브 데모 – https://tts.femoon.top
소스 코드 – https://github.com/Femoon/tts-azure-web
이슈 트래커 – 리포지토리에서 링크된 GitHub Issues 페이지.

TL;DR: TTS Azure Web은 Azure의 신경망 TTS API를 깔끔한 UI로 감싸는, 바로 실행 가능한 Next.js 앱으로, 단순한 슬라이더와 완전한 SSML 편집을 지원하며, Vercel, Docker 또는 로컬 Node를 통해 쉽게 배포할 수 있습니다.