Async 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"}

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"}

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"}

Code examples

Prerequisite: Complete the steps in Get Started.