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

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.

Tracking requests

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

{ "client_reference_id": "MyReferenceId" }

See code example below.

Webhooks

Instead of polling, configure webhooks to receive a notification when a job finishes or fails. This enables fully asynchronous processing.

Learn more about webhooks →

Limits

File limits

You must manually delete files after obtaining transcription results. Files are not deleted automatically. Limit increases (except file duration) can be requested in the Soniox Console.

Transcription limits

To keep creating new transcriptions:

• Stay below 100 pending at a time
• Remove completed/failed transcriptions so total stays under 2,000

Limit increases (except file duration) can be requested in the Soniox Console.

Code examples