Punctuation
Deepgram’s Punctuation feature adds punctuation and capitalization to your transcript.
Use Cases
Some examples of use cases for punctuation include:
- Customers who want transcripts to be more readable.
Enable Feature
To enable punctuation, when you call Deepgram’s API, add a punctuate parameter set to true in the query string:
punctuate=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 \
--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'
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. |
| Truth | Before punctuate | After punctuate |
|---|---|---|
| well it it isn't working i can't get the screen to turn on it was fine yesterday but today it's just a solid black screen it won't come on even when i tap the home button or the power button | well it it isn't working i can't get the screen to turn on it was fine yesterday but today it's just a solid black screen it won't come on even when i tap the home button or the power button | Well, it isn't working. I can't get the screen to turn on. It was fine yesterday. But today it's just a solid black screen. It won't come on even when I tap the home button or the power button. |
| Truth | Before punctuate | After punctuate |
|---|---|---|
| because this phone is really important to me and i'm just seriously worried because i've got a lot of important stuff on it like all of the photos they've taken and contacts i've saved i've got my passwords on there just a lot of things that i wouldn't be able to replace and i'd really love to be able to keep it or get it back or save it or something | because this phone is really important to me and i'm just seriously worried because i've got a lot of important stuff on it like all of the photos they've taken and contacts i've saved i've got my passwords on there just a lot of things that i wouldn't be able to replace and i'd really love to be able to keep it or get it back or save it or something | Because this phone is really important to me, and I'm just seriously worried because I've got a lot of important stuff on it, like, all of the photos they've taken and contacts I've saved. I've got my passwords on there. Just a lot of things that I wouldn't be able to replace. And I'd really love to be able to keep it or get it back or save it or something. |
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.