문제 해결

WhisperX의 첫 받아쓰기가 오래 걸림

모델은 처음 사용할 때 다운로드되므로 연결 상태와 모델 크기(최대 약 3 GB)에 따라 몇 분 걸릴 수 있습니다. 진행 상황에 로드 중인지 표시됩니다. 모델은 옵션이 바뀌지 않는 한 메모리에 남아 있으므로 이후 받아쓰기는 바로 시작됩니다.

WhisperX가 CUDA out of memory로 실패함

GPU 메모리가 설정에 비해 부족합니다. 다음 순서로 시도하세요.

1. 환경설정 → 받아쓰기에서 배치 크기를 낮춥니다(예: 4).
2. 더 작은 모델을 사용합니다(예: small 또는 base).
3. 더 가벼운 연산 유형을 사용합니다(예: int8).

마지막 두 가지는 품질이 떨어질 수 있습니다. 모델별 필요 메모리는 엔진을 참고하세요.

받아쓰기가 너무 오래 걸림

WhisperX의 속도는 하드웨어에 따라 달라지므로 사양이 낮은 CPU에서는 즉각적인 결과를 기대하기 어렵습니다. small 같은 작은 모델, GPU에서 large-v3-turbo, 또는 연산 유형 int8을 시도해 보세요. Apple 실리콘 Mac에서는 GPU로 받아쓰도록 환경설정 → 받아쓰기에서 CPU 사용이 꺼져 있는지 확인하세요. 원격 서버에서 실행되는 Whisper API나 Google API를 사용할 수도 있습니다.

Whisper API가 429 오류를 반환함

RateLimitError("Error code: 429 - {'error': {'message': 'You exceeded your current quota, ...', 'type': 'insufficient_quota', ...}}")

OpenAI 계정의 크레딧이 떨어졌거나, API를 처음 쓰기 전에 충전해야 합니다(무료 크레딧이 있어도 마찬가지). OpenAI 계정의 Billing에서 크레딧을 구매하세요. 계정이 활성화되기까지 최대 10분이 걸릴 수 있습니다.

처음 충전하기 전에 API 키를 만들었고 10분이 지나도 오류가 계속된다면, 새 키를 만들어 환경설정 → API 키에서 설정하세요.

화자가 식별되지 않음

받아쓰기가 화자를 식별하려면 Hugging Face 토큰이 필요합니다. 또는 **화자 식별 모델을 다운로드할 수 없습니다.**와 함께 실패한다면 토큰이 없거나, 유효하지 않거나, 모델에 접근할 수 없는 것입니다.

화자 식별에는 Hugging Face 토큰과 모델 이용 조건 동의가 필요합니다. 다음을 확인하세요.

• 같은 계정으로 pyannote/speaker-diarization-community-1의 이용 조건에 동의했는지.
• 토큰이 Read 역할이며 환경설정 → API 키에 설정되어 있는지.

화자를 식별하려면을 참고하세요.

마이크를 찾을 수 없거나 아무것도 녹음되지 않음

• 마이크가 연결되어 있는지 확인하고 마이크 목록 옆의 새로 고침 버튼을 클릭하세요.
• macOS에서는 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서, Windows에서는 설정 → 개인 정보 → 마이크에서 Audiotext를 허용하세요.
• 레벨 미터에 소리가 없습니다가 표시되면 목록에서 다른 마이크를 고르거나 음소거되지 않았는지 확인하세요.
• **녹음된 오디오가 없습니다.**가 표시되면 마이크가 소리를 보내기 전에 녹음이 끝난 것입니다. 다시 녹음하거나 다른 마이크를 고르세요.

실시간 텍스트가 표시되지 않음

녹음 중에 **녹음 중에는 텍스트를 표시할 수 없습니다.**가 표시되면 실시간 모델을 불러오지 못한 것입니다. 예를 들어 처음 사용할 때 다운로드되므로 인터넷 연결이 필요하거나, 메모리가 부족할 수 있습니다. 녹음에는 영향이 없으며, 멈추면 평소처럼 받아쓰기됩니다. 실시간 텍스트 카드에서 더 작은 실시간 모델(예: tiny 또는 base)을 고르세요.

받아쓰기의 오디오를 재생할 수 없음

원본 파일이 이동되었거나 삭제되었습니다. 텍스트는 남지만 오디오는 원본 파일에서만 재생할 수 있습니다. 마이크 녹음과 URL의 오디오는 Audiotext가 보관합니다.

YouTube 동영상을 다운로드할 수 없음

URL이 올바르고 동영상이 공개 상태인지 확인하세요. YouTube는 자주 바뀌므로 계속 실패한다면 Audiotext의 새 버전이 있는지 확인하세요.

대신 **YouTube 동영상에 오디오 트랙이 없습니다.**가 표시되면 동영상에 받아쓸 소리가 없는 것입니다.

링크를 받아쓸 수 없음

• URL이 오디오 또는 동영상 파일을 가리키지 않습니다.: 링크가 파일이 아닌 웹 페이지를 엽니다. YouTube 동영상 링크와 오디오 또는 동영상 파일의 직접 링크만 사용할 수 있습니다. 페이지에서 파일을 다운로드하는 링크(예: 팟캐스트 에피소드)를 찾아 사용하거나, 파일을 다운로드해 파일 소스로 받아쓰세요.
• 파일을 다운로드할 수 없습니다: …: 파일에 접근할 수 없었습니다. 링크가 브라우저에서 열리는지, 인터넷에 연결되어 있는지 확인하세요. 로그인이 필요한 링크는 다운로드할 수 없으므로 파일을 직접 다운로드해 파일 소스를 사용하세요.

폴더의 파일이 하나도 받아써지지 않음

이미 받아쓰기가 있는 파일은 건너뛰며, 숨김 파일과 다음과 일치하는 파일 건너뛰기에 일치하는 파일도 건너뜁니다. 다시 받아쓰려면 폴더의 ⋯ 메뉴에서 **모두 다시 받아쓰기…**를 사용하거나 파일 목록에서 파일을 선택하세요. 하위 폴더의 파일은 하위 폴더 포함가 켜져 있을 때만 받아쓰며, 폴더에는 지원되는 파일이 있어야 합니다.

Google API가 언어를 요구함

Google API는 언어를 감지할 수 없습니다. 설정에서 오디오 언어를 고르세요.

요약, 답변, 번역이 실패함

• DeepL은 다음 언어로 번역할 수 없습니다: ….: DeepL이 그 언어를 지원하지 않습니다. 언어 모델 같은 다른 제공자를 고르세요.
• 모델의 응답이 너무 깁니다., 모델이 올바른 요약을 반환하지 않았습니다., 모델이 올바른 응답을 반환하지 않았습니다. 또는 모델이 올바른 번역을 반환하지 않았습니다.: 모델이 요약, 답변, 번역을 예상한 형식으로 작성하지 않았습니다. 다시 시도하거나 환경설정 → 제공자에서 더 큰 모델을 고르세요. Ollama의 작은 모델은 더 자주 실패합니다.
• 그 밖의 오류라면 제공자의 API 키가 환경설정 → API 키에 설정되어 있는지, 계정에 크레딧이 있는지 확인하세요.

신뢰도가 낮은 단어에 밑줄이 그어지지 않음

받아쓰기의 ⋯ 메뉴에서 신뢰도가 낮은 단어 강조가 켜져 있는지 확인하세요. 받아쓰기에 점수가 없으면 메뉴에 이유가 표시됩니다.

• “단어별 타이밍”을 켜고 다시 전사하세요: WhisperX는 단어의 타이밍을 정할 때 단어를 평가합니다.
• 이 언어에 대한 정렬 모델이 없습니다: 그 언어의 단어는 타이밍을 정할 수도, 평가할 수도 없습니다.
• 단어를 평가하려면 다시 전사하세요: 단어를 평가하기 전에 받아쓴 것입니다.
• WhisperX와 whisper-1만 단어를 평가합니다: 다른 엔진과 모델은 평가하지 않습니다.

신뢰도가 낮은 단어 검토를 참고하세요.

자막이 있는 동영상에 네모가 표시됨

자막이 있는 동영상을 내보낸 뒤 **…(으)로 내보냈지만, 다음 문자가 있는 글꼴이 없어 네모로 표시됩니다: …**가 표시되면, 시스템의 어떤 글꼴도 그 문자를 그릴 수 없다는 뜻입니다. 해당 문자 체계의 글꼴(예: Noto)을 설치하고 다시 내보내세요.

업데이트를 확인할 수 없음

**업데이트를 확인할 수 없습니다.**는 Audiotext가 GitHub에 연결하지 못했다는 뜻입니다. 인터넷 연결을 확인하거나 방화벽 또는 프록시가 막고 있지 않은지 확인하세요. 최신 버전은 언제든지 릴리스 페이지에서 다운로드할 수 있습니다.

기타

issues를 검색하거나 토론에서 질문하세요. 버그를 발견하면 시스템, Audiotext 버전, 재현 단계를 적어 신고해 주세요.