CAcartesia
Stt

Batch Speech-to-Text

Transcribes an audio file of any length

post/stt

Request

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.

Request body multipart/form-data

filestring binary required

There's no need to break up your audio file. Long files are intelligently chunked by our server.

Supported audio formats: flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, wav, webm

model'ink-whisper' required

ID of the model to use for transcription. Must be in the ink-whisper family of models.

language'en' | 'zh' | 'de' | 'es' | 'ru' | 'ko' | 'fr' | 'ja' | 'pt' | 'tr' | 'pl' | 'ca' | 'nl' | 'ar' | 'sv' | 'it' | 'id' | 'hi' | 'fi' | 'vi' | 'he' | 'uk' | 'el' | 'ms' | 'cs' | 'ro' | 'da' | 'hu' | 'ta' | 'no' | 'th' | 'ur' | 'hr' | 'bg' | 'lt' | 'la' | 'mi' | 'ml' | 'cy' | 'sk' | 'te' | 'fa' | 'lv' | 'bn' | 'sr' | 'az' | 'sl' | 'kn' | 'et' | 'mk' | 'br' | 'eu' | 'is' | 'hy' | 'ne' | 'mn' | 'bs' | 'kk' | 'sq' | 'sw' | 'gl' | 'mr' | 'pa' | 'si' | 'km' | 'sn' | 'yo' | 'so' | 'af' | 'oc' | 'ka' | 'be' | 'tg' | 'sd' | 'gu' | 'am' | 'yi' | 'lo' | 'uz' | 'fo' | 'ht' | 'ps' | 'tk' | 'nn' | 'mt' | 'sa' | 'lb' | 'my' | 'bo' | 'tl' | 'mg' | 'as' | 'tt' | 'haw' | 'ln' | 'ha' | 'ba' | 'jw' | 'su' | 'yue'

The language of the input audio in ISO-639-1 format

timestamp_granularities[]TimestampGranularity[]

Example request

{
  "model": "ink-whisper"
}

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.

Changes

No recorded changes to this operation across all 1 revision of this API.