For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Ask AIPlaygroundLoginFree API Key
HomeAPI ReferenceVoice AgentSpeech-to-TextText-to-SpeechIntelligenceSelf-Hosted Deployments
HomeAPI ReferenceVoice AgentSpeech-to-TextText-to-SpeechIntelligenceSelf-Hosted Deployments
    • Getting Started with Speech to Text
  • Pre-Recorded Audio
    • Getting Started
    • Feature Overview
    • Template Apps
  • Streaming Audio
    • Compare Flux to Nova-3
  • Models and Languages
    • Models & Languages Overview
    • Languages Support
    • Language Detection
    • Multilingual Codeswitching
    • Model Options
    • Version
  • Formatting
    • Speaker Diarization
    • Dictation
    • Filler Words
    • Measurements
    • Numerals
    • Paragraphs
    • Profanity Filtering
    • Punctuation
    • Redaction
    • Smart Formatting
    • Supported Entity Types
    • Utterances
    • Utterance Split
  • Custom Vocabulary
    • Find and Replace
    • Keyterm Prompting
    • Keywords
    • Search
  • Media Input Settings
    • Channels
    • Encoding
    • Multichannel
    • Sample Rate
  • Results Processing
    • Understanding Word Confidence Scores
    • STT Callback
    • STT Tagging
    • Extra Metadata
  • Migrating
    • Migrating From Amazon Web Services (AWS) Transcribe to Deepgram
    • Migrating From Google Speech-to-Text (STT) to Deepgram
    • Migrating From OpenAI Whisper to Deepgram
    • Migrating from AssemblyAI Speech-to-Text to Deepgram
LogoLogo
Ask AIPlaygroundLoginFree API Key
On this page
  • Enable Feature
  • Toggling Numerals during a real-time stream
  • Results
Formatting

Numerals

Numerals converts numbers from written format to numerical format.
Was this page helpful?
Previous

Paragraphs

Paragraphs splits audio into paragraphs to improve transcript readability.
Next
Built with

numerals boolean Default: false

Pre-recorded Streaming:NovaStreaming: Flux Specific languages only

Deepgram’s Numerals feature converts numbers from written format to numerical format. For example, the number “nine hundred” would appear in your transcript as “900”.

Supported languages include:

  • Danish: da, da-DK
  • Dutch: nl
  • English: en, en-US, en-AU, en-GB, en-NZ, en-IN
  • French: fr, fr-CA
  • German: de
  • German (Switzerland): de-CH
  • Italian: it
  • Norwegian: no
  • Polish: pl
  • Portuguese: pt, pt-BR, pt-PT
  • Spanish: es, es-419
  • Swedish: sv, sv-SE
  • Russian: ru
  • Hebrew: he
  • Romanian: ro

When using Nova-3 Multilingual (model=nova-3, language=multi), numeral formatting is supported for: English, Spanish, French, German, Russian, Portuguese, Italian, and Dutch. Numeral formatting is not currently supported for Hindi or Japanese.

Enable Feature

To enable numerals, when you call Deepgram’s API, add a numerals parameter set to true in the query string:

numerals=true

To transcribe audio from a file on your computer, run the following cURL command in a terminal or your favorite API client.

Be sure to replace the placeholder YOUR_DEEPGRAM_API_KEY with your Deepgram API Key. You can create an API Key in the Deepgram Console.

cURL
$curl \
> --request POST \
> --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \
> --header 'Content-Type: audio/wav' \
> --data-binary @youraudio.wav \
> --url 'https://api.deepgram.com/v1/listen?numerals=true'

Toggling Numerals during a real-time stream

In addition to the query string parameter, if you’re sending real-time streaming data, you can turn Numerals on or off at any point during the stream. To do so, send the following JSON message to the websocket:

JSON
1{
2 "type": "Configure",
3 "features": {
4 "numerals": true
5 }
6}

Numerals can be turned on and off multiple times during a stream if desired.

Results

Once applied, results will appear in the transcript.

SourceBefore numeralsAfter numerals
My account number is nine two eight four seven three seven three nine two three sevenMy account number is nine two eight four seven three seven three nine two three sevenMy account number is 9 2 8 4 7 3 7 3 9 2 3 7
SourceBefore numeralsAfter numerals
My customer ID code is five one y w capital k capital p capital o six four one five lowercase d as in dog capital q lowercase p capital l z lowercase a m and then twenty threeMy customer ID code is five one y w capital k capital p capital o six four one five lowercase d as in dog capital q lowercase p capital l z lowercase a m and then twenty threeMy customer ID code is 5 1 y w capital k capital p capital o 6 4 1 5 lowercase d as in dog capital q lowercase p capital l z lowercase a m and then 23
SourceBefore numeralsAfter numerals
My phone number is five five five two one two four three nine four and I live at five five five main street new york new york one zero zero zero fiveMy phone number is five five five two one two four three nine four and I live at five five five main street new york new york one zero zero zero fiveMy phone number is 5 5 5 2 1 2 4 3 9 4 and I live at 5 5 5 main street new york new york 1 0 0 0 5

When punctuation is enabled, converted numbers do not include it. For example, 999,999 will always be transcribed as 999999.