Whizi voice mode werkt niet: elke foutmelding en de oplossing

Het korte antwoord

Voice mode faalt om een van vier redenen: het account is niet ingelogd of heeft geen spraakminuten meer, de browser blokkeerde de microfoon, de realtime verbinding met de spraakdienst mislukte, of de sessie liep tegen een van haar eigen limieten aan. De melding die Whizi toont, vertelt je welke, en elke melding komt overeen met precies een voorwaarde in de code.

Zoek de tekst die je ziet op in deze tabel en lees daarna de bijbehorende sectie hieronder voor de details.

Wat je ziet	Waar het vandaan komt	Wat te doen
Sign in to Whizi to use voice mode.	Geen sessietoken wanneer de voice-overlay opent	Log in en open voice mode opnieuw
Upgrade your subscription to talk with Whizi in voice mode.	Een gratis account start een spraaksessie	Neem een abonnement: gratis accounts krijgen 0 spraakminuten
Your monthly voice minutes have been used up.	De spraakreservering voor deze periode werd geweigerd	Wacht tot de periode opnieuw begint, of upgrade naar een hoger niveau
Microphone access is blocked. Allow it in your browser to use voice mode.	Het microfoonverzoek werd afgewezen door de browser	Sta de microfoon toe voor whizi.io en probeer opnieuw
This browser does not support realtime voice.	Geen getUserMedia of geen AudioContext	Gebruik een browser die beide ondersteunt
Realtime voice is not configured yet. Please try again later.	De sleutel van de spraakprovider staat niet op de server	Hier kun je zelf niets aan doen: probeer het later opnieuw
The realtime voice connection failed.	Een websocketfout tijdens de sessie	Probeer opnieuw en controleer het netwerk
Voice sessions are limited to 15 minutes. Start a new session to continue.	De sessietimer bereikte de limiet van 15 minuten	Start een nieuwe sessie

De server van Whizi maakt alleen een kortlevend sessietoken aan, en de browser opent daarna zelf een websocket rechtstreeks naar de spraakprovider. Er gaat geen audio via de backend van Whizi. Daarom liggen microfoonfouten volledig bij je browser, terwijl de meldingen in de sectie over de verbinding afkomstig zijn van het aanmaken van het token op de server of van de provider daarachter.

Voice mode start niet: de accountgrenzen

Drie weigeringen gebeuren voordat er ook maar audio wordt opgenomen, en geen van drie is een bug.

Sign in to Whizi to use voice mode. De voice-overlay geeft dit weer wanneer er geen token beschikbaar is. Een uitgelogde of verlopen sessie veroorzaakt dit. Log in en open voice mode opnieuw.

Upgrade your subscription to talk with Whizi in voice mode. Dit is HTTP 402 met code subscription_required, teruggegeven wanneer een gratis account probeert een spraaksessie te starten. Gratis accounts hebben een budget van 0 spraakminuten, dus er is geen gedeeltelijke toegang om op terug te vallen. Het goedkoopste abonnement met spraakminuten is Starter voor $15.99/maand, met 10 realtime spraakminuten per maand.

Your monthly voice minutes have been used up. en Your weekly voice minutes have been used up. Dit is HTTP 429 met code voice_limit_reached, gegeven wanneer de spraakreservering voor de periode wordt geweigerd. Het woord is "weekly" bij een wekelijkse factureringscyclus en "monthly" in de rest, dus welke van de twee je ziet, vertelt je op welke cyclus jouw abonnement staat.

De budgetten, per maandelijkse factureringsperiode:

Abonnement	Spraakminuten per maand
Free	0
Starter	10
Pro	80
Powerhouse	500

Wekelijkse factureringsperiodes krijgen een kwart van het maandelijkse budget, naar boven afgerond: 3 minuten bij Starter, 20 bij Pro, 125 bij Powerhouse.

De microfoon start niet

Deze vier meldingen komen allemaal van de browserkant van voice mode, voor of tijdens de opname. Omdat audio nooit bij de servers van Whizi terechtkomt, heeft niets aan je account of abonnement er invloed op.

This browser does not support realtime voice. Verschijnt wanneer getUserMedia of AudioContext niet beschikbaar is. Dit is een controle van de mogelijkheden, geen toestemmingsprobleem, dus geen enkele toestemming lost dit op. Probeer een andere browser.

Microphone access is blocked. Allow it in your browser to use voice mode. Verschijnt wanneer het microfoonverzoek wordt afgewezen met NotAllowedError of SecurityError. Geef de site toegang tot de microfoon en start de sessie opnieuw.

The microphone could not be started. De verzamelmelding voor elke andere microfoonfout. Als de toestemming is gegeven en de browser geschikt is, wijst deze melding naar het apparaat zelf of naar een andere applicatie die de ingang bezet houdt.

Voice mode could not start. De terugvalmelding die wordt gebruikt wanneer de startprocedure een fout geeft zonder eigen tekst, dus zonder details om op te reageren. Loop achtereenvolgens toestemming, browser en apparaat na.

De verbinding mislukt of valt weg

Het starten van een sessie kent twee stappen die los van elkaar kunnen mislukken: de server maakt een token aan, en de browser opent een websocket. De meldingen laten zien welke stap misging.

Fouten bij het aanmaken van het token:

Melding	Status en code	Oorzaak
Realtime voice is not configured yet. Please try again later.	503 voice_live_unavailable	De API-sleutel van de provider staat niet op de worker
Realtime voice is temporarily rate-limited. Please retry shortly.	429 provider_rate_limited	Het aanmaken van het token bij de upstream provider gaf 429 terug
Whizi could not start a realtime voice session.	502 voice_live_unavailable	Elke andere upstream fout bij het aanmaken van het token
Whizi received an invalid realtime voice token.	502 voice_live_unavailable	Het aanmaken lukte, maar er kwam geen tokennaam terug
Realtime voice is not available in this build yet.	503 voice_not_configured	De gedeelde API-basis ontbreekt, of het spraakdomein staat niet aan voor deze build
Whizi received an invalid realtime voice session.	502 invalid_voice_live_response	De sessiepayload voldeed niet aan de validatie, waaronder een websocket-URL die niet begint met de verwachte providerhost
Request failed ({status}).	Wisselend	De terugval van de client wanneer een foutbericht bij een spraakfout niet te lezen is

De eerste vier rijen komen van het aanmaken van het token op de worker van Whizi of van de provider daarachter. Geen enkele clientinstelling, browserwijziging of abonnementswijziging lost ze op. Probeer het straks opnieuw, en als dezelfde melding blijft terugkomen, neem dan contact op met support met de exacte melding en het tijdstip.

Fouten op de websocket zelf:

Melding	Oorzaak
Whizi could not reach the realtime voice service.	De websocket sloot voordat de opzet voltooid was
The realtime voice connection was closed.	De websocket sloot nadat de opzet voltooid was
The realtime voice connection failed.	Er trad een websocketfout op

De overlay geeft een mislukte sessie de status Connection error. Een sluiting voor de opzet wijst op bereikbaarheid (bijvoorbeeld een netwerk dat de websocket blokkeert), en een sluiting na de opzet wijst op een onderbreking tijdens de sessie.

Ook opnieuw proberen kent een eigen plafond. Het starten of beëindigen van een spraaksessie is beperkt tot elk 6 verzoeken per minuut, dus het herhaaldelijk indrukken van de startknop wisselt het ene probleem in voor een 429. Zie rate limits voor de andere vensters waar zo'n herhaling tegenaan loopt.

De sessie is vanzelf gestopt

Vier manieren van afsluiten zijn opzettelijk, en elk heeft zijn eigen melding.

Voice sessions are limited to 15 minutes. Start a new session to continue. Een enkele spraaksessie is beperkt tot 15 minuten (900 seconden), ongeacht hoeveel van je budget nog over is. Deze melding verschijnt wanneer de timer dat volledige maximum bereikt, en een nieuwe sessie starten is de bedoelde weg.

This session used the last of your plan's voice minutes for this period. De startaanroep reserveert seconden en geeft terug hoe lang deze specifieke sessie mag duren, en dat getal wordt kleiner als je nog maar weinig minuten over hebt. Wanneer de server de sessie korter maakte dan het maximum van 15 minuten, krijg je aan het einde deze melding in plaats van de meldingen over het plafond.

Whizi ended the session after a couple of quiet minutes. Tap retry when you want to keep talking. De inactiviteitstimer liep af zonder dat er gesproken werd. Dit is de melding om op te letten als je klacht is "hij hoorde me nooit": een sessie die helemaal geen spraak opvangt, eindigt zo in plaats van open te blijven staan. Zie je dit terwijl je zeker wel aan het praten was, dan ligt het probleem eerder dan de timer, in de microfoonsectie hierboven.

The realtime voice session is ending. Start a new session to continue. De upstream dienst stuurde een goAway-frame, waarmee de provider vraagt om de verbinding af te bouwen. Start een nieuwe sessie.

Het sessietoken wordt aangemaakt met een levensduur van 16 minuten, een minuut speling boven op het plafond van 15 minuten voor de sessie. Een sessie kan haar token niet overleven, en het plafond is altijd wat je als eerste raakt.

De foutmelding zelf lezen

Kijk je naar een netwerktrace of meld je een probleem, dan is de code in de foutmelding de nuttigere helft ervan. Dit zijn de codes die voice mode kan geven: subscription_required, voice_limit_reached, voice_live_unavailable, provider_rate_limited, voice_not_configured, invalid_voice_live_response en rate_limit_reached.

Voor wat er gebeurt met wat je zei, benoemt de trainingsverklaring spraak expliciet: Whizi gebruikt je prompts, bestanden, gesprekken, spraaktranscripten of gegenereerde content niet om Whizi-eigen AI-modellen te trainen, en verkoopt die content niet als trainingsdata. De volledige details staan bij wat Whizi doet met je gegevens.