API ReferenceBatch Transcribe

Create Batch Transcription

Create multiple transcriptions in a single batch request. **Choose a processing mode:** - **Express mode**: Transcriptions start immediately. Max 10 files. Higher cost. Pass `audio_sources` directly in the request. Pricing for v1 is $1.20/hour. - **Standard mode**: Transcriptions processed within 24 hours. Max 500 files. Lower cost. First upload a manifest via [Upload Batch Manifest File](/api-reference/batch-transcribe/upload-batch-file), then pass the `batch_file_id` here. Pricing for v1 batch standard is $0.90/hour. If you need higher limits, contact support@sofer.ai. All files in the batch share the same transcription settings (model, language, etc.) defined in `info`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
infoobjectRequired

Transcription settings applied to all files in the batch (model, language, etc.)

processing_modeenumOptional

Choose how the batch is processed:

  • standard (default): Lower cost, processed within 24 hours. Max 500 files. Use with batch_file_id. Pricing for v1 batch standard is $0.90/hour. If you need higher limits, contact support@sofer.ai.
  • express: Higher cost, starts immediately. Max 10 files. Use with audio_sources. Pricing for v1 is $1.20/hour.
Allowed values:
batch_file_idUUIDOptional

For standard mode only. ID of a previously uploaded batch manifest.

Get this by calling Upload Batch Manifest File first.

audio_sourceslist of objectsOptional

For express mode only. List of audio URLs to transcribe (max 10).

Each item needs an audio_url and can optionally include a title, num_speakers, or auto_detect_speakers.

batch_titlestringOptional

Default title prefix for transcriptions. Individual items can override this. Items without titles become “{batch_title} - Item 1”, “{batch_title} - Item 2”, etc.

Response

Returns the batch ID and individual transcription IDs. Use Get Batch Status to track progress.

batch_idUUID

Use this ID to check batch progress via Get Batch Status

transcription_idslist of UUIDs

IDs for each transcription in the batch. Use these to retrieve individual results via Get Transcription

total_countinteger
Number of transcriptions created
statusenum

Initial batch status (typically RECEIVED)

Allowed values:

Errors

401
Authentication Error
429
Rate Limit Error