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": "job8f3a1b2c4d5e6f7890abcdef12345678",
  "transcription_config": {
    "language": "en",
    "operating_point": "standard",
    "diarization": "none"
  },
  "input_s3_uri": "s3://slng-production-batch-input/inputs/job8f3a.../audio.wav",
  "output_s3_prefix": "s3://slng-production-batch-output/outputs/job8f3a.../",
  "upload": {
    "url": "https://slng-production-batch-input.s3.amazonaws.com/inputs/job8f3a.../audio.wav?X-Amz-Algorithm=...",
    "s3_key": "inputs/job8f3a.../audio.wav",
    "s3_uri": "s3://slng-production-batch-input/inputs/job8f3a.../audio.wav",
    "expires_in": 1800,
    "headers": {
      "Content-Type": "application/octet-stream"
    }
  }
}

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

Presigned upload URL issued (only when the request body has mode: "presign"). The job is not yet created — PUT the file to the returned upload.url, then call this endpoint again with the returned job_id and upload.s3_key to actually create the job.

job_id
string
required

Job identifier to reuse in step 3.

transcription_config
object
required

Transcription settings.

input_s3_uri
string
required

s3://bucket/key of the future upload.

output_s3_prefix
string
required

s3://bucket/outputs/<jobId>/ where transcripts will land.

upload
object
required
tracking
object

Metadata for organizing and filtering jobs.

output_config
object

Output format settings.