La risposta breve
La modalità vocale non funziona per uno di quattro motivi: l'account non ha effettuato l'accesso o non ha più minuti vocali disponibili, il browser ha bloccato il microfono, la connessione in tempo reale al servizio vocale è fallita, oppure la sessione ha raggiunto uno dei propri limiti. Il messaggio mostrato da Whizi indica quale di questi è, e ogni messaggio corrisponde esattamente a una condizione nel codice.
Trova il testo che stai vedendo in questa tabella, poi leggi la sezione corrispondente qui sotto per i dettagli.
| Cosa vedi | Da dove proviene | Cosa fare |
|---|---|---|
Sign in to Whizi to use voice mode. | Nessun token di sessione quando si apre l'overlay vocale | Accedi, poi riapri la modalità vocale |
Upgrade your subscription to talk with Whizi in voice mode. | Un account gratuito che avvia una sessione vocale | Abbonati: gli account gratuiti hanno 0 minuti vocali |
Your monthly voice minutes have been used up. | La riserva vocale del periodo è stata rifiutata | Attendi il reset del periodo, oppure passa a un piano superiore |
Microphone access is blocked. Allow it in your browser to use voice mode. | La richiesta del microfono è stata rifiutata dal browser | Consenti il microfono per whizi.io e riprova |
This browser does not support realtime voice. | Nessun getUserMedia o nessun AudioContext | Usa un browser che supporti entrambi |
Realtime voice is not configured yet. Please try again later. | La chiave del provider vocale non è impostata sul server | Non puoi fare nulla: riprova più tardi |
The realtime voice connection failed. | Un errore websocket durante la sessione | Riprova e controlla la rete |
Voice sessions are limited to 15 minutes. Start a new session to continue. | Il timer della sessione ha raggiunto il limite di 15 minuti | Avvia una nuova sessione |
Il server di Whizi genera solo un token di sessione a breve durata, e il browser apre poi un websocket direttamente verso il provider vocale. Nessun audio passa dal backend di Whizi. Ecco perché gli errori del microfono sono interamente locali al tuo browser, mentre le stringhe nella sezione sulla connessione provengono dalla generazione del token sul server o dal provider a monte di esso.
La modalità vocale non si avvia: i blocchi dell'account
Tre rifiuti avvengono prima che venga catturato qualsiasi audio, e nessuno di essi è un bug.
Sign in to Whizi to use voice mode. L'overlay vocale mostra questo messaggio quando non è disponibile alcun token. Una sessione disconnessa o scaduta lo produce. Accedi e riapri la modalità vocale.
Upgrade your subscription to talk with Whizi in voice mode. Questo è l'HTTP 402 con codice subscription_required, restituito quando un account gratuito tenta di avviare una sessione vocale. Gli account gratuiti hanno un'assegnazione di 0 minuti vocali, quindi non c'è un accesso parziale su cui ripiegare. Il piano più economico con una qualsiasi assegnazione vocale è Starter a $15.99/mese, che include 10 minuti vocali in tempo reale al mese.
Your monthly voice minutes have been used up. e Your weekly voice minutes have been used up. Questi sono l'HTTP 429 con codice voice_limit_reached, generati quando la riserva vocale del periodo viene rifiutata. Il termine è "weekly" su un ciclo di fatturazione settimanale e "monthly" negli altri casi, quindi quale dei due vedi ti dice su quale ciclo si trova il tuo piano.
Le assegnazioni, per periodo di fatturazione mensile:
| Piano | Minuti vocali al mese |
|---|---|
| Free | 0 |
| Starter | 10 |
| Pro | 80 |
| Powerhouse | 500 |
I periodi di fatturazione settimanale prendono un quarto dell'assegnazione mensile, arrotondato per eccesso: 3 minuti su Starter, 20 su Pro, 125 su Powerhouse.
Il microfono non si avvia
Questi quattro messaggi provengono tutti dal lato browser della modalità vocale, prima o durante la cattura. Poiché l'audio non raggiunge mai i server di Whizi, nulla riguardo al tuo account o piano li influenza.
This browser does not support realtime voice. Mostrato quando getUserMedia o AudioContext non sono disponibili. Si tratta di un controllo di compatibilità, non di un problema di autorizzazione, quindi nessuna concessione di permessi lo risolverà. Prova un browser diverso.
Microphone access is blocked. Allow it in your browser to use voice mode. Mostrato quando la richiesta del microfono viene rifiutata con NotAllowedError o SecurityError. Concedi l'accesso al microfono al sito e avvia di nuovo la sessione.
The microphone could not be started. Il messaggio generico per qualsiasi altro errore del microfono. Se il permesso è concesso e il browser è compatibile, questo messaggio indica il dispositivo stesso o un'altra applicazione che sta occupando l'ingresso audio.
Voice mode could not start. Il messaggio di riserva usato quando la sequenza di avvio genera un errore privo di un proprio messaggio, quindi non porta alcun dettaglio su cui agire. Controlla nell'ordine: permessi, browser e dispositivo.
La connessione fallisce o si interrompe
Avviare una sessione prevede due passaggi che possono fallire indipendentemente: il server genera un token, poi il browser apre un websocket. Le stringhe indicano quale passaggio si è interrotto.
Errori durante la generazione del token:
| Messaggio | Stato e codice | Causa |
|---|---|---|
Realtime voice is not configured yet. Please try again later. | 503 voice_live_unavailable | La chiave API del provider non è impostata sul worker |
Realtime voice is temporarily rate-limited. Please retry shortly. | 429 provider_rate_limited | La generazione del token a monte ha risposto 429 |
Whizi could not start a realtime voice session. | 502 voice_live_unavailable | Qualsiasi altro errore a monte nella generazione del token |
Whizi received an invalid realtime voice token. | 502 voice_live_unavailable | La generazione è riuscita ma non ha restituito un nome del token |
Realtime voice is not available in this build yet. | 503 voice_not_configured | La base API condivisa è mancante, oppure il dominio vocale non è abilitato per questa build |
Whizi received an invalid realtime voice session. | 502 invalid_voice_live_response | Il payload della sessione non ha superato la validazione, incluso un URL websocket che non inizia con l'host del provider previsto |
Request failed ({status}). | Varia | Il fallback lato client quando il corpo di un errore vocale non può essere letto |
Le prime quattro righe provengono dalla generazione del token sul worker di Whizi o dal provider a monte di esso. Nessuna impostazione client, cambio di browser o cambio di piano li risolve. Riprova a breve e, se la stessa stringa persiste, contatta il supporto con il messaggio esatto e l'orario.
Errori sul websocket stesso:
| Messaggio | Causa |
|---|---|
Whizi could not reach the realtime voice service. | Il websocket si è chiuso prima del completamento della configurazione |
The realtime voice connection was closed. | Il websocket si è chiuso dopo il completamento della configurazione |
The realtime voice connection failed. | Si è verificato un evento di errore del websocket |
L'overlay etichetta una sessione fallita con lo stato Connection error. Una chiusura prima della configurazione indica un problema di raggiungibilità (per esempio una rete che blocca il websocket), mentre una chiusura dopo la configurazione indica un'interruzione a metà sessione.
Anche i cicli di ritentativo hanno un proprio limite massimo. Avviare o terminare una sessione vocale è limitato a 6 richieste al minuto ciascuna, quindi premere ripetutamente il pulsante di avvio trasforma il problema originale in un errore 429. Consulta i limiti di frequenza per le altre finestre in cui un ritentativo incide.
La sessione si è conclusa da sola
Quattro conclusioni sono intenzionali, e ognuna ha il proprio messaggio.
Voice sessions are limited to 15 minutes. Start a new session to continue. Una singola sessione vocale è limitata a 15 minuti (900 secondi), indipendentemente da quanto della tua assegnazione rimane. Questo messaggio compare quando il timer raggiunge quel limite massimo, e avviare una nuova sessione è il percorso previsto.
This session used the last of your plan's voice minutes for this period. La chiamata di avvio riserva dei secondi e restituisce per quanto tempo questa particolare sessione può durare, e quella cifra si riduce quando i minuti rimanenti sono pochi. Quando il server ha ridotto la sessione al di sotto del massimo di 15 minuti, questo è il messaggio che ricevi alla fine invece del messaggio del limite massimo.
Whizi ended the session after a couple of quiet minutes. Tap retry when you want to keep talking. Il timeout di inattività è scaduto senza rilevare alcun parlato. Questo è il messaggio da cercare se il tuo sintomo è "non mi ha mai sentito": una sessione che non cattura alcun parlato termina in questo modo invece di rimanere aperta. Se vedi questo messaggio mentre stavi sicuramente parlando, il problema è a monte del timeout, nella sezione sul microfono qui sopra.
The realtime voice session is ending. Start a new session to continue. Il servizio a monte ha inviato un frame goAway, ovvero il provider che chiede di chiudere gradualmente la connessione. Avvia una nuova sessione.
Il token di sessione viene generato con una durata di 16 minuti, un minuto di margine oltre il limite di 15 minuti della sessione. Una sessione non può sopravvivere al proprio token, e il limite massimo è sempre ciò che si raggiunge per primo.
Leggere l'errore da soli
Se stai esaminando una traccia di rete o segnalando un problema, il code nel corpo dell'errore è la metà più utile. Questi sono i codici che la modalità vocale può produrre: subscription_required, voice_limit_reached, voice_live_unavailable, provider_rate_limited, voice_not_configured, invalid_voice_live_response e rate_limit_reached.
Per quanto riguarda cosa succede a ciò che hai detto, la dichiarazione sull'addestramento copre esplicitamente la voce: Whizi non utilizza i tuoi prompt, file, conversazioni, trascrizioni vocali o contenuti generati per addestrare modelli AI di proprietà di Whizi, e non vende questi contenuti come dati di addestramento. Il dettaglio completo si trova in cosa fa Whizi con i tuoi dati.
- Gli account gratuiti hanno 0 minuti vocali, quindi il messaggio di upgrade 402 è previsto
- Assegnazioni mensili: Starter 10, Pro 80, Powerhouse 500 minuti
- "Weekly" in un messaggio di limite significa che l'account è su un ciclo di fatturazione settimanale
- Gli errori del microfono sono interamente lato browser: nessun audio passa dai server di Whizi
This browser does not support realtime voice.significa che mancagetUserMediaoAudioContext, e i permessi non possono risolverlo- Gli errori nella generazione del token (503 e 502) sono lato server: riprova più tardi o contatta il supporto
- Una sessione è limitata a 15 minuti indipendentemente dall'assegnazione rimanente
- Una sessione senza alcun parlato viene terminata dal timeout di inattività
- Avviare una sessione è limitato a 6 al minuto, quindi i cicli di ritentativo si ritorcono contro
Domande frequenti
Whizi dice che il mio microfono è bloccato, ma funziona in altre app. Cosa faccio?
Quella stringa esatta, Microphone access is blocked. Allow it in your browser to use voice mode., viene mostrata quando la richiesta del microfono è rifiutata con NotAllowedError o SecurityError. Concedi l'accesso al microfono al sito e avvia di nuovo la sessione. Se invece vedi The microphone could not be started., il permesso non era il problema: quel messaggio è il messaggio generico per qualsiasi altro errore del microfono.
La modalità vocale dice che non è configurata. È colpa del mio account?
No. Realtime voice is not configured yet. Please try again later. è l'HTTP 503, restituito quando la chiave API del provider vocale non è impostata sul server, e Realtime voice is not available in this build yet. è l'equivalente lato client quando il dominio vocale non è abilitato per quella build. Nessuno dei due è risolvibile dal tuo lato. Riprova più tardi e, se persiste, contatta il supporto con la stringa esatta.