Soniox

Get started

Learn how to use Soniox Speech-to-Text API.

Learn how to use Soniox Speech-to-Text API in minutes

Soniox Speech-to-Text is a universal speech AI that lets you transcribe speech in 60+ languages — from recorded files (async) or live audio streams (real-time). Languages can be freely mixed within the same conversation, and Soniox will handle them seamlessly with high accuracy and low latency.

In just a few steps, you can run your first transcription. The examples also cover real-time and async transcription flows through the same simple API.

Get API key

Create a Soniox account and log in to the Console to get your API key.

API keys are created per project. In the Console, go to My First Project and click API Keys to generate one.

Export it as an environment variable (replace with your key):

Terminal
export SONIOX_API_KEY=<YOUR_API_KEY>

Get examples

Clone the official examples repo:

Terminal
git clone https://github.com/soniox/soniox_examples
cd soniox_examples/speech_to_text

Run examples

Choose your language and run the ready-to-use examples below.

Example
What it doesOutput
Real-time
transcription		Transcribes speech in any language in
real-time.		Transcript streamed to console.
Transcribe file from URLTranscribes an audio file directly from a public URL.Transcript printed to console.
Transcribe local fileUploads and transcribes an audio file from your computer.Transcript printed to console.
Terminal
cd python_sdk

# Set up environment
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Real-time examples
python soniox_sdk_realtime.py --audio_path ../assets/coffee_shop.mp3

# Async examples
python soniox_sdk_async.py --audio_url "https://soniox.com/media/examples/coffee_shop.mp3"
python soniox_sdk_async.py --audio_path ../assets/coffee_shop.mp3
Terminal
cd nodejs_sdk

# Install dependencies
npm install

# Real-time examples
node soniox_sdk_realtime.js --audio_path ../assets/coffee_shop.mp3

# Async examples
node soniox_sdk_async.js --audio_url "https://soniox.com/media/examples/coffee_shop.mp3"
node soniox_sdk_async.js --audio_path ../assets/coffee_shop.mp3
Terminal
cd python

# Set up environment
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Real-time examples
python soniox_realtime.py --audio_path ../assets/coffee_shop.mp3

# Async examples
python soniox_async.py --audio_url "https://soniox.com/media/examples/coffee_shop.mp3"
python soniox_async.py --audio_path ../assets/coffee_shop.mp3
Terminal
cd nodejs

# Install dependencies
npm install

# Real-time examples
node soniox_realtime.js --audio_path ../assets/coffee_shop.mp3

# Async examples
node soniox_async.js --audio_url "https://soniox.com/media/examples/coffee_shop.mp3"
node soniox_async.js --audio_path ../assets/coffee_shop.mp3

Next steps

  • Dive into the Real-time API → Run live transcription and endpoint detection.
  • Explore the Async API → Transcribe recorded files at scale and integrate with webhooks.

Introduction

Soniox provides powerful, production-ready APIs for transcribing, translating, generating, and understanding audio content.

Real-time transcription

Learn about real-time transcription with low latency and high accuracy for all 60+ languages.