---
title: "Batch Speech-to-Text"
method: POST
path: "/stt"
tags: ["Stt"]
---

# Batch Speech-to-Text

`POST /stt`

Transcribes an audio file of any length

## 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](/build-with-cartesia/stt/audio-input).
- `sample_rate` integer, nullable

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- TranscriptionResponse
  - `type` 'transcript', required — The message type. Always `transcript` for a batch transcription response.
  - `request_id` string — Unique identifier for this transcription request.
  - `text` string, required — The transcribed text.
  - `is_final` boolean — Not used for batch transcription.
  - `language` string — The specified language of the input audio.
  - `duration` number, double — The duration of the input audio in seconds.
  - `words` TranscriptionWord[] — Word-level timestamps showing the start and end time of each word. Only included when `[word]` is passed into `timestamp_granularities[]`.
    - `word` string, required — The transcribed word.
    - `start` number, double, required — Start time of the word in seconds.
    - `end` number, double, required — End time of the word in seconds.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)
