Skip to main content
POST

Authorizations

chariotai-api-key
string
header
required

Your Chariot API key, generated from the dashboard. Send it in the chariotai-api-key header on every request.

Body

multipart/form-data

Send exactly one of input_audio_file or input_audio_url as multipart/form-data. Other fields apply to either input.

input_audio_file
file
required

The audio or video file bytes. The file must contain a readable audio track. Supply this or input_audio_url, not both.

language
enum<string>
default:none

Requested transcription language. Omit or use none for automatic detection. This does not request translation.

Available options:
none,
en,
hi,
bn,
gu,
kn,
ml,
mr,
or,
pa,
sa,
ta,
te
mode
enum<string>
default:high_accuracy

File transcription always uses high_accuracy. balanced is only supported by the live WebSocket.

Available options:
high_accuracy
style
enum<string>
default:codemix

Writing style for mixed-language speech. codemix keeps borrowed words in their own script; native writes them in the spoken language's script.

Available options:
codemix,
native
include_timestamps
boolean
default:false

Return estimated word timestamps in seconds from the start of the file. Applies to either file upload or URL input.

model_type
enum<string>
default:chariot-1-asr-realtime

Public ASR model. The same model_type is used across WebSocket, file and batch transcription.

Available options:
chariot-1-asr-realtime

Response

Complete transcription.

One complete file transcript; uploaded channels are mixed to mono.

request_id
string
required

Identifier for this transcription request.

created
string<date-time>
required

Response creation time in UTC.

text
string
required

Complete recognized text, empty when no speech is recognized.

duration
number
required

Processed audio duration in seconds, not request latency.

model_type
enum<string>
default:chariot-1-asr-realtime

Public streaming ASR model_type values, the same parameter name TTS uses. A product name, never the checkpoint or serving name behind it: the upstream's served name is configuration and is never sent to a caller.

Available options:
chariot-1-asr-realtime
words
ASRWordTimestamp · object[] | null

Estimated word boundaries in seconds from the start of the file when include_timestamps=true. Null when requested but unavailable or invalid; an empty list means no timed words. Also empty when timestamps are not requested.