Start Job
curl --request POST \
--url https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start \
--header 'X-API-Key-ID: <api-key>'import requests
url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start"
headers = {"X-API-Key-ID": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key-ID': '<api-key>'}};
fetch('https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "STARTING",
"message": "Job start accepted. File validation and queueing are running in the background. Poll GET /stt/v3/batch/jobs/{job_id} to track progress."
}Batch transcription
Start job
Start processing a batch transcription job.
POST
/
stt
/
v3
/
batch
/
jobs
/
{job_id}
/
start
Start Job
curl --request POST \
--url https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start \
--header 'X-API-Key-ID: <api-key>'import requests
url = "https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start"
headers = {"X-API-Key-ID": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'X-API-Key-ID': '<api-key>'}};
fetch('https://api.vachana.ai/stt/v3/batch/jobs/{job_id}/start', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "STARTING",
"message": "Job start accepted. File validation and queueing are running in the background. Poll GET /stt/v3/batch/jobs/{job_id} to track progress."
}Overview
Part of Batch transcription, which covers the whole flow, models, languages and limits. Start transcription for a job inCREATED status. Returns 202 Accepted while validation and queueing run in the background.
Creating a job does not start processing — you must call this endpoint.
For public-URL jobs, path validation happens here. If every path fails, status becomes START_FAILED.
Authentication
| Header | Required | Description |
|---|---|---|
X-API-Key-ID | Yes | Your Gnani API key |
Path parameters
In Try it, paste a real
job_id from Create job before clicking Send. Leaving the placeholder {job_id} in the URL returns 422.string
default:"019fa854-1db0-7e45-a026-7a6b09ff6d7c"
required
Job ID returned by Create job. Replace with your own
job_id before sending.Example cURL
curl --request POST \
--url https://api.vachana.ai/stt/v3/batch/jobs/019fa79e-81f9-7a8a-a446-6eff16ddec30/start \
--header 'X-API-Key-ID: <YOUR_API_KEY>'
Example — Python SDK
from gnani.stt import GnaniSTTBatchClient
client = GnaniSTTBatchClient()
job = client.get_job("<job_id>") # or the job returned by create_job(start=False)
job.start()
print(job.status) # STARTING
client.create_job(...) already starts the job unless you pass start=False, so most programs never call start(). See the Python SDK.
Response
Success (202)
{
"job_id": "019fa79e-81f9-7a8a-a446-6eff16ddec30",
"status": "STARTING",
"message": "Job start accepted. File validation and queueing are running in the background. Poll GET /stt/v3/batch/jobs/{job_id} to track progress."
}
Error responses
409 Already started / finished{
"error": "JOB_ALREADY_STARTED",
"message": "Job cannot be restarted from state 'FAILED'"
}
{
"error": "JOB_NOT_FOUND",
"message": "Job 01900000-0000-7000-8000-000000000000 not found"
}
{
"error": "JOB_CANCELLED",
"message": "Job was cancelled before starting"
}
string
Job identifier.
string
Typically
STARTING after a successful start.Use cases
- Kicking off transcription after files are uploaded
- Starting a public-URL job after create
Was this page helpful?