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: application/json' \
  --data '
{
  "input_url": "<string>",
  "transcription_config": {
    "language": "en",
    "operating_point": "standard",
    "diarization": "none",
    "domain": "<string>",
    "output_locale": "<string>",
    "enable_entities": true,
    "additional_vocab": [
      {
        "content": "<string>",
        "sounds_like": [
          "<string>"
        ]
      }
    ]
  },
  "job_id": "<string>",
  "model_code": "slng/speechmatics/batch:15.0.0",
  "metadata": {},
  "tracking": {
    "title": "Meeting recording",
    "reference": "ref-123",
    "tags": [
      "meeting",
      "q1-review"
    ],
    "details": "Q1 planning session"
  },
  "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"
    }
  }
}

Authorizations

Authorization
string
header
required

API key from the SLNG dashboard.

Body

input_url
string<uri>
required

HTTPS URL of the audio file to transcribe. Must be publicly accessible or a presigned URL.

transcription_config
object
required

Transcription settings.

job_id
string

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

Pattern: ^[a-zA-Z0-9]+$
model_code
string
default:slng/speechmatics/batch:15.0.0

Model to use for transcription.

metadata
object

Arbitrary key-value metadata to attach to the job.

tracking
object

Metadata for organizing and filtering jobs.

output_config
object

Output format settings.

Response

Presign mode only. Returns a presigned upload URL; the job is not created yet. See the Batch guide for the full upload flow.

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.