Skip to main content
POST
Transcribe audio

Authorizations

Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Body

multipart/form-data
file
file
required

Audio file (wav, mp3, m4a, flac, ogg).

model
string
default:pyai-hear
response_format
enum<string>
default:json
Available options:
json,
text,
verbose_json
language
enum<string>

ISO-639-1 language code. Omit for automatic language detection. Values outside the published set are rejected with 400 unsupported_language, never silently auto-detected.

Available options:
en,
es,
fr,
de,
hi,
it,
pt,
nl
numerals
boolean

Tri-state inverse-text normalization for English final transcripts (never interim partials). true renders spoken numbers as digits (phones, currency, dates, ordinals). false keeps those spans in spoken form. Omitted keeps the live engine default: number formatting is ON for finals. Independent of smart_format.

smart_format
boolean
default:false

Opt-in English punctuation and sentence capitalization on final transcripts only. Interim partials are never formatted. May change only case and punctuation; any failure returns the unformatted final. Default false. Independent of numerals. Non-English requests are unchanged.

dictation
boolean
default:false

Opt-in spoken punctuation commands on English final transcripts only: period, comma, new paragraph, and question mark. Separate from smart_format and off by default. Interim partials are never rewritten.

drop_fillers
boolean
default:false

Opt-in stripping of filled pauses (um, uh, umm, uhh, er) on English final transcripts. Off by default. Do not enable on legal or compliance audio by default. Interim partials are never rewritten.

vocabulary
string

Per-call phrase list (max 32 phrases, 64 characters each). Re-cases matching spans to the supplied form and boosts those phrases for this request only. Not a stored project glossary. Send a comma-separated list or a JSON array string.

seed
integer

Optional determinism seed for reproducible eval runs. Forwarded to the engine and honored once the engine supports it; no effect when omitted.

temperature
number

Optional sampling temperature for reproducible eval runs. Forwarded to the engine and honored once the engine supports it; no effect when omitted.

Response

Transcription result

text
string
model
string