Whizi 음성 모드가 작동하지 않을 때: 모든 오류와 해결법

짧은 답변

음성 모드가 실패하는 이유는 네 가지 중 하나입니다: 계정이 로그인되어 있지 않거나 음성 사용 시간이 남아 있지 않은 경우, 브라우저가 마이크를 차단한 경우, 음성 서비스로의 실시간 연결이 실패한 경우, 또는 세션이 자체 한도에 도달한 경우입니다. Whizi가 보여주는 메시지를 보면 어떤 경우인지 알 수 있으며, 각 메시지는 코드상 정확히 하나의 조건에 대응합니다.

지금 보고 있는 문구를 아래 표에서 찾은 다음, 해당하는 아래 섹션에서 자세한 내용을 확인하세요.

보이는 문구	발생 원인	조치 방법
Sign in to Whizi to use voice mode.	음성 오버레이가 열릴 때 세션 토큰이 없음	로그인한 다음 음성 모드를 다시 여세요
Upgrade your subscription to talk with Whizi in voice mode.	무료 계정이 음성 세션을 시작함	구독하세요: 무료 계정은 음성 사용 시간이 0분입니다
Your monthly voice minutes have been used up.	기간별 음성 예약이 거부됨	기간이 초기화되기를 기다리거나 상위 요금제로 변경하세요
Microphone access is blocked. Allow it in your browser to use voice mode.	브라우저가 마이크 요청을 거부함	whizi.io에 마이크 접근을 허용하고 다시 시도하세요
This browser does not support realtime voice.	getUserMedia 또는 AudioContext가 없음	둘 다 지원하는 브라우저를 사용하세요
Realtime voice is not configured yet. Please try again later.	서버에 음성 제공업체 키가 설정되어 있지 않음	사용자가 할 수 있는 조치 없음: 나중에 다시 시도하세요
The realtime voice connection failed.	세션 중 웹소켓 오류	다시 시도하고 네트워크를 확인하세요
Voice sessions are limited to 15 minutes. Start a new session to continue.	세션 타이머가 15분 한도에 도달함	새 세션을 시작하세요

Whizi 서버는 단기 세션 토큰만 발급하며, 그 후 브라우저가 음성 제공업체로 직접 웹소켓을 엽니다. 오디오는 Whizi 백엔드를 거치지 않습니다. 그래서 마이크 오류는 전적으로 브라우저에서 일어나는 문제이며, 반면 연결 섹션에 나오는 문구들은 서버의 토큰 발급 과정이나 그 상위의 제공업체에서 비롯됩니다.

음성이 시작되지 않음: 계정 관련 제한

오디오가 캡처되기 전에 세 가지 거부가 발생하며, 이들은 버그가 아닙니다.

Sign in to Whizi to use voice mode. 음성 오버레이는 토큰이 없을 때 이 메시지를 표시합니다. 로그아웃 상태이거나 세션이 만료되면 발생합니다. 로그인한 다음 음성 모드를 다시 여세요.

Upgrade your subscription to talk with Whizi in voice mode. 무료 계정이 음성 세션을 시작하려고 할 때 반환되는 HTTP 402, 코드 subscription_required입니다. 무료 계정은 음성 사용 시간이 0분이므로, 대신 사용할 수 있는 부분적인 접근권도 없습니다. 음성 사용 시간이 포함된 가장 저렴한 요금제는 월 $15.99의 Starter이며, 월 10분의 실시간 음성 사용 시간이 포함됩니다.

Your monthly voice minutes have been used up. 그리고 Your weekly voice minutes have been used up. 이는 기간별 음성 예약이 거부될 때 발생하는 HTTP 429, 코드 voice_limit_reached입니다. 요금제가 주 단위 결제 주기이면 "weekly"가, 그렇지 않으면 "monthly"가 표시되므로, 어느 쪽이 보이는지로 결제 주기를 알 수 있습니다.

월별 결제 주기 기준 사용 한도:

요금제	월별 음성 사용 시간(분)
Free	0
Starter	10
Pro	80
Powerhouse	500

주간 결제 주기는 월 한도의 4분의 1을 올림하여 적용합니다: Starter는 3분, Pro는 20분, Powerhouse는 125분입니다.

마이크가 시작되지 않음

이 네 가지 메시지는 모두 캡처 전이나 캡처 중, 음성 모드의 브라우저 쪽에서 발생합니다. 오디오가 Whizi 서버에 도달하지 않으므로, 계정이나 요금제와는 전혀 관련이 없습니다.

This browser does not support realtime voice. getUserMedia 또는 AudioContext를 사용할 수 없을 때 표시됩니다. 이는 권한 문제가 아니라 기능 지원 여부를 확인하는 것이므로, 권한을 아무리 허용해도 해결되지 않습니다. 다른 브라우저를 사용해 보세요.

Microphone access is blocked. Allow it in your browser to use voice mode. 마이크 요청이 NotAllowedError 또는 SecurityError로 거부될 때 표시됩니다. 사이트에 마이크 접근 권한을 허용한 다음 세션을 다시 시작하세요.

The microphone could not be started. 그 외의 모든 마이크 오류를 포괄하는 메시지입니다. 권한이 허용되어 있고 브라우저가 지원 가능한 상태라면, 이 메시지는 장치 자체 문제이거나 다른 애플리케이션이 입력 장치를 점유하고 있음을 가리킵니다.

Voice mode could not start. 시작 절차가 자체 메시지 없이 실패했을 때 사용되는 대체 메시지로, 조치할 수 있는 세부 정보가 없습니다. 권한, 브라우저, 장치 순서로 하나씩 확인하세요.

연결이 실패하거나 끊김

세션을 시작하는 과정에는 각각 독립적으로 실패할 수 있는 두 단계가 있습니다: 서버가 토큰을 발급하고, 그다음 브라우저가 웹소켓을 엽니다. 표시되는 문구를 보면 어느 단계에서 문제가 생겼는지 알 수 있습니다.

토큰 발급 중 발생하는 오류:

메시지	상태 코드	발생 원인
Realtime voice is not configured yet. Please try again later.	503 voice_live_unavailable	제공업체 API 키가 워커에 설정되어 있지 않음
Realtime voice is temporarily rate-limited. Please retry shortly.	429 provider_rate_limited	상위 토큰 발급 요청이 429로 응답함
Whizi could not start a realtime voice session.	502 voice_live_unavailable	토큰 발급 과정에서 발생한 그 외의 모든 상위 오류
Whizi received an invalid realtime voice token.	502 voice_live_unavailable	발급은 성공했지만 토큰 이름이 반환되지 않음
Realtime voice is not available in this build yet.	503 voice_not_configured	공유 API 기본 주소가 없거나, 이 빌드에서 음성 도메인이 활성화되어 있지 않음
Whizi received an invalid realtime voice session.	502 invalid_voice_live_response	세션 페이로드가 검증에 실패함, 예상 제공업체 호스트로 시작하지 않는 웹소켓 URL 포함
Request failed ({status}).	다양함	음성 오류 본문을 읽을 수 없을 때의 클라이언트 대체 처리

처음 네 행은 Whizi 워커의 토큰 발급 과정이나 그 상위의 제공업체에서 비롯됩니다. 클라이언트 설정이나 브라우저, 요금제를 바꿔도 해결되지 않습니다. 잠시 후 다시 시도하고, 같은 문구가 계속 나타나면 정확한 메시지와 발생 시각을 알려주며 지원팀에 문의하세요.

웹소켓 자체에서 발생하는 오류:

메시지	발생 원인
Whizi could not reach the realtime voice service.	웹소켓이 설정 완료 전에 닫힘
The realtime voice connection was closed.	웹소켓이 설정 완료 후에 닫힘
The realtime voice connection failed.	웹소켓 오류 이벤트가 발생함

오버레이는 실패한 세션을 Connection error 상태로 표시합니다. 설정 완료 전 종료는 연결 가능 여부(예: 웹소켓을 차단하는 네트워크)를 가리키고, 설정 완료 후 종료는 세션 도중 발생한 중단을 가리킵니다.

재시도 루프에도 자체 한도가 있습니다. 음성 세션의 시작과 종료는 각각 분당 6회 요청으로 제한되므로, 시작 버튼을 계속 누르면 원래 문제가 429 오류로 바뀔 뿐입니다. 재시도가 걸리는 다른 제한 구간은 속도 제한에서 확인하세요.

세션이 스스로 종료됨

네 가지 종료는 의도된 동작이며, 각각 고유한 메시지를 가집니다.

Voice sessions are limited to 15 minutes. Start a new session to continue. 남은 사용 시간과 관계없이 하나의 음성 세션은 15분(900초)으로 제한됩니다. 타이머가 이 최대치에 도달하면 이 메시지가 표시되며, 새 세션을 시작하는 것이 의도된 방법입니다.

This session used the last of your plan's voice minutes for this period. 세션 시작 요청은 초 단위로 시간을 예약하고 이번 세션이 진행될 수 있는 시간을 반환하는데, 남은 사용 시간이 적으면 이 수치가 줄어듭니다. 서버가 세션을 15분 최대치보다 짧게 줄인 경우, 종료 시 한도 메시지 대신 이 메시지가 표시됩니다.

Whizi ended the session after a couple of quiet minutes. Tap retry when you want to keep talking. 발화 없이 유휴 시간 제한이 지났을 때 표시됩니다. "내 말을 전혀 듣지 못했다"는 증상이라면 이 메시지를 확인하세요: 음성이 전혀 캡처되지 않은 세션은 계속 열려 있지 않고 이렇게 종료됩니다. 분명히 말을 하고 있었는데도 이 메시지가 보인다면, 문제는 시간 제한보다 앞선 단계, 즉 위의 마이크 섹션에 있습니다.

The realtime voice session is ending. Start a new session to continue. 상위 서비스가 goAway 프레임을 보낸 것으로, 제공업체가 연결 종료를 요청하는 것입니다. 새 세션을 시작하세요.

세션 토큰은 15분 세션 한도보다 1분 여유를 둔 16분 수명으로 발급됩니다. 세션은 토큰보다 오래 지속될 수 없으며, 항상 한도에 먼저 도달합니다.

오류를 직접 읽어보기

네트워크 추적을 보고 있거나 문제를 신고하는 경우, 오류 본문의 code가 더 유용한 정보입니다. 음성 모드가 생성할 수 있는 코드는 다음과 같습니다: subscription_required, voice_limit_reached, voice_live_unavailable, provider_rate_limited, voice_not_configured, invalid_voice_live_response, rate_limit_reached입니다.

말한 내용이 어떻게 처리되는지에 관해서는, 학습 정책이 음성을 명시적으로 다룹니다: Whizi는 사용자의 프롬프트, 파일, 대화, 음성 기록, 생성된 콘텐츠를 Whizi 소유 AI 모델 학습에 사용하지 않으며, 해당 콘텐츠를 학습 데이터로 판매하지도 않습니다. 자세한 내용은 Whizi가 데이터를 다루는 방식에서 확인하세요.