Skip to main content
POST
Transcribe audio

Authorizations

Authorization
string
header
required

Token from the discovery file. Required on every endpoint except /health.

Body

application/json
file
string

Absolute filesystem path. Mutually exclusive with audio_base64.

audio_base64
string

base64-encoded audio bytes. Pair with mime_type.

mime_type
string

e.g. audio/wav, audio/m4a, audio/mpeg, audio/flac

mode_id
string<uuid>

Saved Mode used as the baseline. May be combined with engine/model/language to override per-call.

engine
string

whisperLocal | parakeet | qwen3Asr | appleSpeech |

model
string
language
string

Response

200 - application/json

Transcript or business error envelope

ok
boolean
text
string
engine
string
model
string
language
string | null
timings
object
latency_ms
integer