Soniox Setup Tutorial

1Create a Soniox Account

Go to console.soniox.com/signup and create a free account. If you already have a Soniox account, sign in directly at console.soniox.com.

2Open the Console

After signing in, open the Soniox Console. Your account starts with a default project ("My First Project").

3Go to API Keys

In the Console, open your project and click the API Keys section in the sidebar.

4Create an API Key

Click Create new key, give it a name (e.g. "Sokuji"), and confirm. Copy the key immediately — it is shown only once.

5Configure in Sokuji

Open Sokuji and select Soniox as your AI provider in the settings panel. Paste your API Key, choose the source language (or Auto Detect) and target language, and pick a voice. In the Speech block (Quick settings, or Settings → Advanced → Audio), Translation the other side hears decides whether your translation is spoken or text only.

6Test the Connection

Click the Start Session button and speak into your microphone to verify that real-time translation works. You should see the transcript and the translation. The spoken translation goes into the virtual microphone for the other side; to hear it yourself, turn on I hear it too in the Speech block.

What is Soniox?

Soniox is an end-to-end real-time speech translation service:

• Real-time speech-to-speech translation: transcription, translation, and speech synthesis in one pipeline
• Transcribe and translate 60+ languages in the same streaming API call, with translation at no extra cost
• Automatic language detection: set the source to Auto Detect and Soniox identifies the spoken language
• 200 built-in voices for the translated speech, and voices you clone from a short recording

Supported Languages

Supports 60+ languages with any-to-any translation between them:

• The source language can be a specific language or Auto Detect
• The target language can be any of the 60+ languages
• Includes Chinese, English, Japanese, Korean, Spanish, French, German, Italian, Portuguese, Russian, and many more

Modes and Options

• Spoken or text only: in the Speech block, Translation the other side hears reads your translation aloud into the virtual microphone, and Translation I hear reads the other side's translation aloud to you. Switch either off and that side stays text only
• Voices: in Settings → Advanced → Provider → Voice Settings, pick one of 200 built-in voices or clone your own. While Translation I hear is on, a second row, Voice I hear, picks the voice that reads the other side to you: built-in voices only, and if you pick your own voice there, another one reads instead
• Two-way translation: in "Both" mode each direction runs in its own Soniox session by default (Shared session in Both mode: Disabled). Choose Enabled to translate both sides in one session with automatic speaker separation, at lower cost and latency; two sessions cost about twice as much but cope better when both people talk at once
• Face-to-face: in "Both" mode, set Other side to Beside me and two people share one microphone, each hearing what the other says, translated, in one earbud. Face-to-face always uses one shared session
• Source language and translation mode: "Auto Detect" works when translating your own voice ("Me" mode). For "Other" or "Both" mode, pick a specific source language — auto-detect cannot be reversed to translate the other side into your language.
• No manual turn-detection setup — Soniox detects speech endpoints on the server

Common Issues

Authentication Error: Verify that your API Key is copied correctly with no extra spaces. If the key was lost, create a new one in the Soniox Console — keys are shown only once.

Connection Error: Check your network connection and ensure firewalls are not blocking WebSocket connections. If using a proxy, make sure it supports WebSocket.

No Translated Audio: If you see the translation but hear nothing, check the Speech block: Translation the other side hears must be on. Your translation goes into the virtual microphone for the other side; to hear it yourself, turn on I hear it too and check the device on that row.

Tips for Best Results

1. Use a stable network connection for the best real-time quality
2. Use in a quiet environment for the best speech recognition
3. Set the source language explicitly if auto-detection picks the wrong language
4. Monitor your usage and balance in the Soniox Console