Sign in

v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB
Stt

Batch Speech-to-Text

Transcribes an audio file of any length

post/stt

Query parameters

encoding'pcm_s16le' | 'pcm_s32le' | 'pcm_f16le' | 'pcm_f32le' | 'pcm_mulaw' | 'pcm_alaw'

Must match the actual encoding of your audio. For detailed guidance on each format, see Audio Input.

Required when uploading raw PCM data without a container header. If not specified, the audio file will be decoded automatically from its container (e.g. WAV, MP3, FLAC).

sample_rateinteger nullable

The sample rate of the audio in Hz.

Headers

Cartesia-Version'2026-03-01' date required
Example:2026-03-01

API version header.

Response

type'transcript' required

The message type. Always transcript for a batch transcription response.

request_idstring

Unique identifier for this transcription request.

textstring required

The transcribed text.

is_finalboolean

Not used for batch transcription.

languagestring

The specified language of the input audio.

durationnumber double

The duration of the input audio in seconds.