Tutorial di configurazione Soniox
Panoramica
Questo tutorial ti guiderà nella configurazione di Soniox per l'uso con Sokuji. Soniox è un servizio di traduzione voce-a-voce in tempo reale che trascrive e traduce oltre 60 lingue in una singola chiamata API di streaming.
1Registra un account Soniox
Vai su console.soniox.com/signup e crea un account gratuito. Se hai già un account Soniox, accedi direttamente su console.soniox.com.
2Apri la console
Dopo l'accesso, apri la console Soniox. Il tuo account inizia con un progetto predefinito ("My First Project").
3Vai su API Keys
Nella console, apri il tuo progetto e clicca sulla sezione API Keys nella barra laterale.
4Crea una chiave API
Clicca su Crea nuova chiave, assegnale un nome (ad es. "Sokuji") e conferma. Copia la chiave immediatamente — viene mostrata una sola volta.
5Configura in Sokuji
Apri Sokuji e seleziona Soniox come fornitore di IA nel pannello impostazioni. Incolla la tua chiave API, scegli la lingua di origine (o rilevamento automatico) e la lingua di destinazione, e seleziona una voce. Nel blocco Voce (impostazioni rapide, oppure Impostazioni → Avanzato → Audio), Traduzione che sente l'altra parte decide se la tua traduzione viene letta ad alta voce o mostrata solo come testo.
6Testa la connessione
Clicca il pulsante Avvia sessione e parla nel microfono per verificare che la traduzione in tempo reale funzioni. Dovresti vedere la trascrizione e la traduzione. La traduzione parlata va nel microfono virtuale per l'altra parte; per sentirla anche tu, attiva Lo sento anche io nel blocco Voce.
Funzionalità
Cos'è Soniox?
Soniox è un servizio di traduzione vocale in tempo reale end-to-end:
- Traduzione voce-a-voce in tempo reale: trascrizione, traduzione e sintesi vocale in un'unica pipeline
- Trascrive e traduce oltre 60 lingue nella stessa chiamata API di streaming, senza costi aggiuntivi per la traduzione
- Rilevamento automatico della lingua: imposta l'origine su rilevamento automatico e Soniox identifica la lingua parlata
- 200 voci integrate per la traduzione parlata, e voci che cloni da una breve registrazione
Lingue supportate
Supporta oltre 60 lingue con traduzione da qualsiasi lingua a qualsiasi altra:
- La lingua di origine può essere una lingua specifica o il rilevamento automatico
- La lingua di destinazione può essere una qualsiasi delle oltre 60 lingue
- Include cinese, inglese, giapponese, coreano, spagnolo, francese, tedesco, italiano, portoghese, russo e molte altre
Modalità e opzioni
- Parlata o solo testo: nel blocco Voce, Traduzione che sente l'altra parte legge la tua traduzione ad alta voce nel microfono virtuale, e Traduzione che sento io ti legge la traduzione dell'altra parte. Disattiva una delle due e quel lato resta solo testo
- Voci: in Impostazioni → Avanzato → Fornitore → Impostazioni Voce, scegli una delle 200 voci integrate o clona la tua. Finché Traduzione che sento io è attiva, una seconda riga, Voce che sento io, sceglie la voce che ti legge l'altra parte: solo voci integrate, e se lì scegli la tua stessa voce, ne legge un'altra al suo posto
- Traduzione bidirezionale: in modalità "Entrambi" ogni direzione usa per impostazione predefinita una propria sessione Soniox (Sessione condivisa in modalità Entrambi: Disabilitato). Scegli Abilitato per tradurre entrambe le parti in un'unica sessione con separazione automatica dei parlanti, con costi e latenza minori; due sessioni costano circa il doppio ma reggono meglio quando entrambe le persone parlano insieme
- Faccia a faccia: in modalità "Entrambi", imposta Dov'è l'altro su Accanto a me; due persone condividono un microfono e ciascuna sente in un auricolare ciò che dice l'altra, tradotto. Il faccia a faccia usa sempre una sessione condivisa
- Lingua di origine e modalità di traduzione: il rilevamento automatico funziona quando traduci la tua voce (modalità "Io"). In modalità "Altro" o "Entrambi", scegli una lingua di origine precisa — il rilevamento automatico non può essere invertito per tradurre l'altra parte nella tua lingua.
- Nessuna configurazione manuale del rilevamento dei turni — Soniox rileva i punti finali del parlato lato server
Risoluzione dei problemi
Problemi comuni
Errore di autenticazione: Verifica che la chiave API sia copiata correttamente senza spazi aggiuntivi. Se la chiave è andata persa, creane una nuova nella console Soniox — le chiavi vengono mostrate una sola volta.
Errore di connessione: Controlla la connessione di rete e assicurati che i firewall non blocchino le connessioni WebSocket. Se usi un proxy, assicurati che supporti WebSocket.
Nessun audio tradotto: Se vedi la traduzione ma non senti nulla, controlla il blocco Voce: Traduzione che sente l'altra parte deve essere attiva. La tua traduzione va nel microfono virtuale per l'altra parte; per sentirla anche tu, attiva Lo sento anche io e controlla il dispositivo di quella riga.
Suggerimenti per i migliori risultati
- Usa una connessione di rete stabile per la migliore qualità in tempo reale
- Usa in un ambiente silenzioso per un riconoscimento vocale ottimale
- Imposta esplicitamente la lingua di origine se il rilevamento automatico sceglie la lingua sbagliata
- Monitora l'utilizzo e il saldo nella console Soniox
Hai bisogno di ulteriore aiuto? Visita la documentazione Soniox per i dettagli o il nostro repository GitHub per supporto.