음성 입력 모델

설정 → 음성 입력 모델에서 엔진을 전환합니다. 속도, 정확도, 오프라인 여부, 언어 지원 기준으로 고를 수 있습니다. 첫 실행 기본값은 대부분 Apple 온디바이스 음성입니다.

Free에서 사용 가능한 엔진

LicenseManager.isASRProviderAllowed:

Free	체험 / Pro
Apple(온디바이스)	전체 카탈로그 엔진
Doubao(BYOK 클라우드)	Bailian, MiMo, Azure, Gemini, OpenAI Speech, Groq, ElevenLabs, Soniox, NVIDIA Speech NIM, OpenAI 호환 / 자체 구축 게이트웨이 등 포함
온디바이스 SenseVoice-Small(sherpa-onnx · 중국어/광둥어/영어/일본어/한국어)
온디바이스 Whisper Large-v3 Turbo(sherpa-onnx · 100+개 언어)
온디바이스 Fun-ASR-Nano(sherpa-onnx · 중·영·일 + 방언)
온디바이스 Parakeet TDT 0.6B v3(sherpa-onnx · 영어 + 유럽 25개 언어)

Base URL이 localhost를 가리켜도 OpenAI 호환 / faster-whisper 등은 여전히 다중 엔진으로 취급되어 Free에서는 사용할 수 없으며, 체험 또는 Pro가 필요합니다. 내장 온디바이스 4종(SenseVoice / Whisper Turbo / Fun-ASR-Nano / Parakeet)은 예외입니다.

주요 엔진

종류	예	네트워크	플랜
시스템 온디바이스	Apple Speech / SpeechAnalyzer	로컬(시스템이 언어 팩을 다운로드할 수 있음)	Free ✓; 클라우드 키 불필요
내장 온디바이스 (sherpa-onnx)	SenseVoice, Whisper Turbo, Fun-ASR-Nano, Parakeet TDT	최초 가중치 다운로드 후 오프라인	Free ✓; API 키 불필요
지역 클라우드	Doubao, Bailian, Xiaomi MiMo	필요	Free는 Doubao만; Bailian / MiMo → 체험/Pro
일반 클라우드	OpenAI Speech, Azure (MAI-Transcribe 2), Gemini, Groq, ElevenLabs, Soniox	필요	BYOK; 체험/Pro
호환 / 셀프호스트	OpenAI 호환, faster-whisper, 로컬 게이트웨이	배포에 따름	`localhost` 가능; 그래도 체험/Pro 필요
NVIDIA 클라우드	Speech NIM (클라우드 Parakeet 등)	필요 또는 셀프호스트	체험/Pro (온디바이스 Parakeet과 별개)

전체 목록은 앱 내 카탈로그 기준입니다. 온디바이스 모델은 통(整) 구간 인식(키를 뗀 후 추론하며, 말하는 동안 스트리밍으로 나오는 방식이 아님)이며, 처음 사용할 때 수백 MB ~ 약 1.5 GB의 런타임/가중치를 다운로드합니다.

API 키

키는 macOS 키체인에 저장됩니다(서비스 이름은 Bundle ID와 연동).
VoiceHotkey는 강제 계정 클라우드를 운영하지 않습니다. 오디오는 선택한 제3자로만 전송되며, 온디바이스 엔진은 오디오를 업로드하지 않습니다.
자세한 내용은 BYOK과 데이터 흐름을 참고하세요.

파일 전사 모델

파일 전사는 실시간 음성 입력과 독립적인 모델 구성을 사용할 수 있습니다(설정 → 파일 전사 → 모델 선택). 엔진 플랜 요건은 실시간 음성 입력과 같습니다(Free: Apple / Doubao / 내장 온디바이스 4종). 파일 전사 참고.

로컬 전용 모드

로컬 전용이 켜져 있으면 루프백이 아닌 공용 엔드포인트는 실패합니다. Apple과 내장 온디바이스 4종은 항상 허용되며, 그 외 엔진은 Base URL / WS를 localhost / 127.0.0.1 / ::1로 지정하고 그와 동시에 위의 플랜 요건도 충족해야 합니다.

고유 명사 정확도 높이기

일부 엔진은 컨텍스트 / 프롬프트 / 사전 항목을 지원합니다(예: Soniox terms, Whisper prompt). 해당 엔진 설정에 사람 이름, 브랜드, 용어를 채워 넣으세요. 전사 후에는 단어 치환으로 보완할 수 있습니다.