Transcription

Overview

Soniox supports asynchronous transcription for audio files. This allows you to transcribe recordings without maintaining a live connection or streaming pipeline.

You can submit audio from:

• A public URL (audio_url)
• A local file uploaded via the Soniox Files API (file_id)

Once submitted, jobs are processed in the background. You can poll for status/results, or use webhooks to get notified when transcription is complete.

Audio input options

Transcribe from public URL

If your audio is publicly accessible via HTTP, use the audio_url parameter:

{ "audio_url": "https://example.com/audio.mp3" }

See code example below.

Transcribe from local file

For local files, upload to Soniox using the Files API. Then reference the returned file_id when creating the transcription request:

{ "file_id": "your_file_id" }

See code example below.

Audio formats

Soniox automatically detects audio formats for file transcription — no configuration required.

Supported formats:

aac, aiff, amr, asf, flac, mp3, ogg, wav, webm, m4a, mp4

Tracking requests

Optionally, add a client-defined identifier to track requests:

{ "client_reference_id": "MyReferenceId" }

See code example below.

Code examples

Prerequisite: This page builds on the setup from the Get Started guide.