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.
FEEDBACK
Did you find what you were looking for?