오디오 - Cloosphere Guide

관리자 › 설정 › 오디오

화면은 위에서부터 STT 설정 → TTS 설정 → 아바타 순으로 배치되어 있습니다.

STT (Speech-to-Text)

사용자 음성 입력을 텍스트로 변환하는 엔진을 설정합니다.

설정 항목	설명	기본값
음성-텍스트 변환 엔진	STT 서비스 선택	`Whisper (로컬)`

서버 내장 faster-whisper 모델로 전사합니다. 기본값이며 외부 API 키가 필요 없습니다.

설정 항목	설명
STT 모델	사용할 Whisper 모델 이름. 서버에 없으면 내려받은 뒤 사용합니다

설정 항목	설명
API 키	Deepgram API 키
STT 모델	선택 사항 — 비워 두면 기본 모델을 사용합니다

설정 항목	설명
API 키	Azure AI Speech Service 키
Azure 지역	Azure 리전 (예: `koreacentral`)
언어 로케일	인식 언어를 콤마로 구분해 지정 (예: `en-US,ja-JP`). 비우면 자동 감지

설정 항목	설명	기본값
GCP 프로젝트 ID	Google Cloud 프로젝트 ID	-
위치	리전	`global`
STT 모델	Cloud Speech-to-Text V2 모델 이름 (예: `chirp_2`)	-
언어 코드	인식 언어 (예: `ko-KR,en-US`)	`auto`
서비스 계정 키 (선택사항)	비워 두면 애플리케이션 기본 자격 증명을 사용합니다	-
전역 Google Cloud 키 사용	서버에 등록된 공통 키를 대신 사용	-

AI 응답을 음성으로 변환하는 엔진을 설정합니다.

설정 항목	설명	기본값
텍스트-음성 변환 엔진	TTS 서비스 선택	`웹 API`
응답 나누기	TTS 요청 시 메시지를 나누는 단위 — `Punctuation`(문장 부호 단위) · `Paragraphs`(문단 단위) · `없음`(메시지 전체를 하나로)	`Punctuation`

브라우저 내장 Web Speech API를 사용합니다. TTS 음성만 고르면 되고 별도 키가 필요 없습니다.

설정 항목	설명
TTS 모델	CMU ARCTIC speaker embedding 이름

설정 항목	설명
API 기본 URL	OpenAI API Endpoint
API 키	API 인증 키
TTS 음성	`alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer` 등
TTS 모델	예: `tts-1`, `tts-1-hd`

설정 항목	설명
API 키	Azure AI Speech Service 키
Azure 지역	Azure 리전 (예: `koreacentral`)
TTS 음성	음성 선택 (예: `ko-KR-SunHiNeural`)
출력 형식	오디오 출력 형식. 라벨 옆 사용 가능한 목록 링크에서 전체 형식을 확인할 수 있습니다

AI 응답 시 표시되는 아바타를 설정합니다.

설정 항목	설명	기본값
아바타 엔진	아바타 서비스 선택 — 사용하지 않으면 `Default (None)`	`Default (None)`

Azure AI Speech를 선택하면 아래 항목이 펼쳐집니다.

설정 항목	설명
API 키	아바타 서비스 인증 키
Azure 지역	서비스 리전 (예: `eastus`, `koreacentral`)
아바타 캐릭터	아바타 캐릭터 선택
아바타 스타일	캐릭터를 고르면 그 캐릭터가 지원하는 스타일 목록이 나타납니다
인사말	아바타가 나타날 때 표시할 첫 인사말. 비우면 기본값을 사용합니다