New sign-ups for the Free plan are temporarily paused. Paid plans remain available.
LDX hub API

CastVoice Jobs

Create and manage CastVoice speech-to-text transcription jobs


List CastVoice job history

GET
https://gw.ldxhub.io
/castvoice/jobs

Returns a list of jobs for the authenticated user, ordered by creation date descending. Use GET /castvoice/jobs/{job_id} to retrieve full details for a specific job.

List CastVoice job history › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List CastVoice job history › Responses

A list of jobs


Create a CastVoice job

POST
https://gw.ldxhub.io
/castvoice/jobs

Enqueues an asynchronous speech-to-text transcription job. Upload your audio file via POST /files first, then submit the file_id here. Returns 202 Accepted immediately with a job_id. Poll GET /castvoice/jobs/{job_id} to check completion. When completed, download the transcription via GET /files/{output_file_id}/content.

Supported input formats: WAV, MP3. The input format is automatically detected from the uploaded file.

Note: For multi-channel audio, only the first channel is transcribed. If speakers are recorded on separate channels, mix the audio down to mono before uploading.

Create a CastVoice job › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Create a CastVoice job › Request Body

engine
​string · required

Engine ID obtained from GET /castvoice/engines

file_id
​string · required

File ID of the input audio file to process, obtained from POST /files. Supported input formats: WAV, MP3. The input format is automatically detected from the uploaded file.

recognizer
​string · required

Recognizer code obtained from 'supported_recognizers' in GET /castvoice/engines. The format depends on the engine (e.g. 'ja-JP', or 'ja-JP|long' for engines that combine a language and a model).

output_format
​string · enum · required

Output format. Use 'srt' for subtitles with timecodes, or 'text' for plain text.

Enum values:
srt
text
split_by_sentence
​boolean

If true, each recognized segment is split at sentence boundaries where possible, with timecodes rebuilt from word-level timestamps. Segments where no sentence boundary is found are left as is. Engines that do not list 'split_by_sentence' in 'supported_options' ignore this parameter.

Default: true

Create a CastVoice job › Responses

Job accepted

Full job details. Returned by GET /castvoice/jobs/{job_id}.
job_id
​string
file_id
​string

Input file ID

engine
​string
status
​string · enum
Enum values:
queued
processing
completed
failed
progress
​number · float
output_file_id
​string

File ID of the transcription output (SRT or plain text). Present only when status is completed. Download via GET /files/{output_file_id}/content.

​JobError

Job-level error. Present only when job status is failed.

created_at
​string · date-time
updated_at
​string · date-time
completed_at
​string · date-time
expires_at
​string · date-time
​Usage

Get CastVoice job status and results

GET
https://gw.ldxhub.io
/castvoice/jobs/{job_id}

Returns the current status of a CastVoice job. Poll this endpoint until status is completed or failed. Recommended polling interval: 15-30 seconds (transcription can take several minutes depending on the audio length). When status is completed, use output_file_id to download the transcription via GET /files/{output_file_id}/content. Results are retained for a limited period after completion (expires_at). If status is failed, check error.code: upstream_service_error and internal_server_error are usually temporary, so submit a new job later. Most other codes, such as invalid_parameter or unsupported_file, mean the input or settings must be fixed first.

Get CastVoice job status and results › path Parameters

job_id
​string · required

The unique identifier of the job

Get CastVoice job status and results › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get CastVoice job status and results › Responses

Job details

Full job details. Returned by GET /castvoice/jobs/{job_id}.
job_id
​string
file_id
​string

Input file ID

engine
​string
status
​string · enum
Enum values:
queued
processing
completed
failed
progress
​number · float
output_file_id
​string

File ID of the transcription output (SRT or plain text). Present only when status is completed. Download via GET /files/{output_file_id}/content.

​JobError

Job-level error. Present only when job status is failed.

created_at
​string · date-time
updated_at
​string · date-time
completed_at
​string · date-time
expires_at
​string · date-time
​Usage