Skip to main content
POST
/
v1
/
batch
/
jobs
Create batch job
curl --request POST \
  --url https://api.batch.slng.ai/v1/batch/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'transcription_config={
  "language": "en",
  "operating_point": "standard",
  "diarization": "none",
  "domain": "<string>",
  "output_locale": "<string>",
  "enable_entities": true,
  "additional_vocab": [
    {
      "content": "<string>",
      "sounds_like": [
        "<string>"
      ]
    }
  ]
}' \
  --form job_id=myjob123 \
  --form model_code=slng/speechmatics/batch:15.0.0 \
  --form 'tracking={
  "title": "Meeting recording",
  "reference": "ref-123",
  "tags": [
    "meeting",
    "q1-review"
  ],
  "details": "Q1 planning session"
}' \
  --form 'output_config={
  "srt_overrides": {
    "max_line_length": 80,
    "max_lines": 2
  }
}'
{
  "job_id": "myjob123",
  "status": "QUEUED"
}

Authorizations

Authorization
string
header
required

API key from the SLNG dashboard.

Body

multipart/form-data
file
file
required

The audio file to transcribe. Supported formats: wav, mp3, flac, aac, ogg, m4a, mp4, amr, mpeg.

transcription_config
object
required

Transcription settings.

job_id
string

Custom alphanumeric identifier for the job. Auto-generated if omitted.

Example:

"myjob123"

model_code
string
default:slng/speechmatics/batch:15.0.0

Model to use for transcription.

tracking
object

Metadata for organizing and filtering jobs.

output_config
object

Output format settings.

Response

202 - application/json

Job accepted and queued for processing.

job_id
string

The job identifier.

status
enum<string>

Current job status.

Available options:
QUEUED,
IN_PROGRESS,
DECODING,
DONE,
FAILED,
DELETED