Skip to main content
Formatting is currently in beta testing. API details subject to change ahead of general release.
Speech to text can be used to create a verbatim transcript of the audio; however, some content is not documented in the same manner as it is verbalized. The formatting features provide control over how key information should for represented in the textual output.

Feature availability:

/transcribe

/stream

/transcripts

Notes:
  • Defining formatting in configuration is optional. When these preferences are not configured, the default values listed below will be applied automatically.
  • Full support for the functionality outlined below is available in English (en), Danish (da), German (de), and French (fr).
  • There are some terms (e.g., homophones) that will be disambiguated by the language model to determine if the symbol or the word should be inserted based on the context. Improvements on this front expected to continue.

​
Formatting Options

The tables below show available enum options for each formatting configuration option.
The options marked as Default indicates how output is formatted when no parameter is set.

​
Dates

OptionFormatExampleDefault
as_dictatedPreserve spoken phrasing”February third twenty twenty five” -> “February 3rd 2025”
long_textLong date”3 February 2025”
eu_slashShort date (EU)“03/02/2025”
us_slashShort date (US)“02/03/2025”
iso_compactISO (basic, no separators)“20250302”

​
Times

OptionFormatExampleDefault
as_dictatedAs dictated”Four o’clock” or “four thirty five” or “sixteen hundred”
h1212-hour”4:00 PM”
h2424-hour”16:00”

​
Numbers

OptionFormatExampleDefault
as_dictatedAs dictated”one, two, … nine, ten, eleven, twelve
numerals_above_nineSingle digit as words, multi-digit as number”One, two … nine, 10, 11, 12”
numeralsNumbers only”1, 2, … 9, 10, 11, 12”

​
Units and Measurements

OptionFormatExampleDefault
as_dictatedAs dictated”Millimeters, centimeters, inches; Blood pressure one twenty over eighty”
abbreviatedAbbreviated”mm, cm, in; BP 120/80”
  • Celsius (°C)
  • Fahrenheit (°F)
  • Kelvin (K)
  • Inch (in)
  • Meter (m)
  • Centimeter (cm)
  • Millimeter (mm)
  • Nanometer (nm)
  • Kilometer (km)
  • Gram (g)
  • Kilogram (kg)
  • Milligram (mg)
  • Microgram (mcg)
  • Nanogram (ng)
  • Pound (lb)
  • Ounce (oz)
  • Liter (L)
  • Milliliter (mL)
  • Deciliter (dL)
  • International unit (IU)
  • Milliequivalent (mEq)
  • Millimole (mmol)
  • Mole (mol)
  • Blood pressure (BP and systole/diastole)
  • Beats per minute (BPM)
  • Respirations per minute (RPM)
  • Body mass index (BMI)
  • Percent (%)
  • Millimeters of mercury (mmHg)
  • Centimeters of water (cmH2O)
  • Nanogram per milliliter (ng/mL)
  • Milligram per deciliter (mg/dL)
  • Milliequivalents per liter (mEq/L)
  • Millimoles per liter (mmol/L)
  • Units per liter (U/L)
  • Pack years (pack-yrs)

​
Ranges

OptionFormatExampleDefault
as_dictatedAs dictated”one to ten”
numeralsAs numbers”1-10”

​
Ordinals

OptionFormatExampleDefault
as_dictatedAs dictated”First, second, third”
numeralsAbbreviated”1st, 2nd, 3rd”
Please contact us to report errors, or for more information on this feature.