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"
}
}
}Create batch job
Submit audio for asynchronous transcription. Supports file upload (multipart/form-data), URL input, and presigned S3 upload (application/json). For the presigned-upload flow, the first call (mode: "presign") returns 200 OK with an upload URL — the job is not created until step 3. All other submission paths return 202 Accepted with status: QUEUED.
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
API key from the SLNG dashboard.
Body
- URL input
- Presigned upload: request a URL
- Presigned upload: create the job
HTTPS URL of the audio file to transcribe. Must be publicly accessible or a presigned URL.
Transcription settings.
Show child attributes
Show child attributes
Custom alphanumeric identifier for the job. Auto-generated if omitted.
^[a-zA-Z0-9]+$Model to use for transcription.
Arbitrary key-value metadata to attach to the job.
Metadata for organizing and filtering jobs.
Show child attributes
Show child attributes
Output format settings.
Show child attributes
Show child attributes
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 identifier to reuse in step 3.
Transcription settings.
Show child attributes
Show child attributes
s3://bucket/key of the future upload.
s3://bucket/outputs/<jobId>/ where transcripts will land.
Show child attributes
Show child attributes
Metadata for organizing and filtering jobs.
Show child attributes
Show child attributes
Output format settings.
Show child attributes
Show child attributes
Was this page helpful?