Skip to main content
POST
Speech to Text
This BETA endpoint accepts audio only as multipart/form-data (a file upload) or application/msgpack. JSON is not supported — the audio cannot be sent as a base64 string.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

audio
file
required

Audio file to be converted to text

language
string | null

Optional hint. The language is auto-detected regardless; the detected language is returned as language_code.

ignore_timestamps
boolean
default:true

Whether to return precise timestamps in the text, this will increase the latency in audio shorter than 30 seconds

Response

Request fulfilled, document follows

text
string
required
duration
number
required

Duration of the audio in seconds

segments
ASRSegment · object[]
required
language_code
string | null

Detected language as an ISO 639-1 code (e.g. en, ja). Omitted if no language is detected.

language
string | null

Detected language name (e.g. English). For display only; use language_code in code.