Stt

Speech-to-Text (Batch)

Transcribes audio files into text using Cartesia's Speech-to-Text API. Upload an audio file and receive a complete transcription response. Supports arbitrarily long audio files with automatic intelligent chunking for longer audio. **Supported audio formats:** flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, wav, webm **Response format:** Returns JSON with transcribed text, duration, and language. Include `timestamp_granularities: ["word"]` to get word-level timestamps. **Pricing:** Batch transcription is priced at **1 credit per 2 seconds** of audio processed. <Note> For migrating from the OpenAI SDK, see our [OpenAI Whisper to Cartesia Ink Migration Guide](/api-reference/stt/migrate-from-open-ai). </Note>

Headers

X-API-KeystringRequired
Cartesia-Version"2024-11-13"RequiredDefaults to 2024-11-13

Query parameters

encodingenumOptional
The encoding format to process the audio as. If not specified, the audio file will be decoded automatically. **Supported formats:** - `pcm_s16le` - 16-bit signed integer PCM, little-endian (recommended for best performance) - `pcm_s32le` - 32-bit signed integer PCM, little-endian - `pcm_f16le` - 16-bit floating point PCM, little-endian - `pcm_f32le` - 32-bit floating point PCM, little-endian - `pcm_mulaw` - 8-bit μ-law encoded PCM - `pcm_alaw` - 8-bit A-law encoded PCM
sample_rateintegerOptional
The sample rate of the audio in Hz.

Request

This endpoint expects a multipart form containing a file.
filefileRequired

The audio file to transcribe. The max file size we support is 2GB. Supported formats: flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, wav, webm.

modelstringRequired

ID of the model to use for transcription. Use ink-whisper for the latest Cartesia Whisper model.

languagestringOptional
The language of the input audio in ISO-639-1 format. Defaults to `en`. <Accordion title="Supported languages"> - `en` (English) - `zh` (Chinese) - `de` (German) - `es` (Spanish) - `ru` (Russian) - `ko` (Korean) - `fr` (French) - `ja` (Japanese) - `pt` (Portuguese) - `tr` (Turkish) - `pl` (Polish) - `ca` (Catalan) - `nl` (Dutch) - `ar` (Arabic) - `sv` (Swedish) - `it` (Italian) - `id` (Indonesian) - `hi` (Hindi) - `fi` (Finnish) - `vi` (Vietnamese) - `he` (Hebrew) - `uk` (Ukrainian) - `el` (Greek) - `ms` (Malay) - `cs` (Czech) - `ro` (Romanian) - `da` (Danish) - `hu` (Hungarian) - `ta` (Tamil) - `no` (Norwegian) - `th` (Thai) - `ur` (Urdu) - `hr` (Croatian) - `bg` (Bulgarian) - `lt` (Lithuanian) - `la` (Latin) - `mi` (Maori) - `ml` (Malayalam) - `cy` (Welsh) - `sk` (Slovak) - `te` (Telugu) - `fa` (Persian) - `lv` (Latvian) - `bn` (Bengali) - `sr` (Serbian) - `az` (Azerbaijani) - `sl` (Slovenian) - `kn` (Kannada) - `et` (Estonian) - `mk` (Macedonian) - `br` (Breton) - `eu` (Basque) - `is` (Icelandic) - `hy` (Armenian) - `ne` (Nepali) - `mn` (Mongolian) - `bs` (Bosnian) - `kk` (Kazakh) - `sq` (Albanian) - `sw` (Swahili) - `gl` (Galician) - `mr` (Marathi) - `pa` (Punjabi) - `si` (Sinhala) - `km` (Khmer) - `sn` (Shona) - `yo` (Yoruba) - `so` (Somali) - `af` (Afrikaans) - `oc` (Occitan) - `ka` (Georgian) - `be` (Belarusian) - `tg` (Tajik) - `sd` (Sindhi) - `gu` (Gujarati) - `am` (Amharic) - `yi` (Yiddish) - `lo` (Lao) - `uz` (Uzbek) - `fo` (Faroese) - `ht` (Haitian Creole) - `ps` (Pashto) - `tk` (Turkmen) - `nn` (Nynorsk) - `mt` (Maltese) - `sa` (Sanskrit) - `lb` (Luxembourgish) - `my` (Myanmar) - `bo` (Tibetan) - `tl` (Tagalog) - `mg` (Malagasy) - `as` (Assamese) - `tt` (Tatar) - `haw` (Hawaiian) - `ln` (Lingala) - `ha` (Hausa) - `ba` (Bashkir) - `jw` (Javanese) - `su` (Sundanese) - `yue` (Cantonese) </Accordion>
timestamp_granularities[]list of enumsOptional

The timestamp granularities to populate for this transcription. Currently only word level timestamps are supported.

Allowed values:

Response

This endpoint returns an object.
textstring
The transcribed text.
languagestring or null
The specified language of the input audio.
durationdouble or null
The duration of the input audio in seconds.
wordslist of objects or null

Word-level timestamps showing the start and end time of each word. Only included when [word] is passed into timestamp_granularities[].