Punctuation

📘
Using Smart Formatting?
If you've set smart_format=true in your API request, Punctuation is automatically enabled.

Enable Feature

To enable punctuation, use the following parameter in the query string when you call Deepgram’s /listen endpoint :

punctuate=true

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

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?punctuate=true'

Replace YOUR_DEEPGRAM_API_KEY with your Deepgram API Key.

Results

Once applied, results will appear in the transcript.

Truth	Before punctuate	After punctuate
hello and thank you for calling premier services please be aware that this call may be recorded for quality training purposes my name is beth and i will be assisting you today	hello and thank you for calling premier services please be aware that this call may be recorded for quality training purposes my name is beth and i will be assisting you today	Hello, and thank you for calling Premier Services. Please be aware that this call may be recorded for quality training purposes. My name is Beth, and I will be assisting you today.

Use Cases

Some examples of use cases for punctuation include:

Customers who want transcripts to be more readable.

ℹ️
By default, Deepgram applies its general AI model, which is a good, general purpose model for everyday situations. To learn more about the customization possible with Deepgram's API, check out the Deepgram API Reference.