Prerecorded
The REST API provides speech-to-text transcription for complete audio files. You upload an audio file and receive the full transcript in the response.
Use it when the audio already exists in full: recordings of finished meetings or calls, voice memos, or an audio archive. When in doubt, see Choosing an Endpoint.
Use the model query parameter to choose the model that transcribes the file. Models differ in speed, features, and languages; see Models for the options. We recommend rumble-2 for most use cases.
Audio Format
Section titled “Audio Format”With the default encoding=auto, the server detects the audio format from the uploaded file; for raw audio, set encoding explicitly. See Audio Formats for the supported formats.
Language
Section titled “Language”The server auto-detects the language by default; use the language query parameter to pin one or constrain detection to a list. See Languages. Set include_language=true to include the detected language in the response.
Diarization
Section titled “Diarization”Pass diarize=true to label transcribed speech by speaker. The response is split into per-speaker segments. See Diarization.
How It Works
Section titled “How It Works”- Authenticate - Include an authentication header in your request.
- Configure - Use query parameters to set the audio encoding and which fields to include in the response.
- Upload audio - Send the audio file as the request body with
Content-Type: application/octet-stream. - Receive transcript - The server processes the entire file and returns the transcript as JSON.
See the API reference for full details on fields and error codes, or Getting Started for a working curl example.