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.
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.