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 'metadata=<string>' \
  --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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.slng.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key from the SLNG dashboard.

Body

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.

Pattern: ^[a-zA-Z0-9]+$
Example:

"myjob123"

metadata
string

JSON object with arbitrary key-value metadata to attach to the job.

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