Make Your First API Request

To access Deepgram’s API, you’ll need to create a Deepgram API Key. Make note of your API Key; you will need it later.

Here are several options for trying out the Deepgram API. These examples are meant to help you make a first request to Deepgram; we encourage you to try out one of our Getting Started guides to learn more.

Make a request without writing any code! Head to the Deepgram Playground to try out the API. No sign-up required!

Run the following cURL command in your shell. Be sure to replace the DEEPGRAM_API_KEY with your own key.

curl \
  --request POST \
  --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://static.deepgram.com/examples/interview_speech-analytics.wav"}' \
  --url 'https://api.deepgram.com/v1/listen?model=nova-3&smart_format=true'

For more examples using CURL, check out the Transcribing Pre-Recorded Audio guide.

This section will help you get set up to use Deepgram’s SDKs. Then you can continue on to one of the Getting Started guides, which demonstrate how to make common API requests with Deepgram’s officially supported SDKs.

We provide sample scripts throughout our documentation in the languages of our SDKs and assume you have already configured your development environment. System requirements will vary depending on the programming language you use:

• Node.js: node >= 14.14.37
• Python: python >= 3.10
• .NET: dotnet >= 6.0
• GO: Go >= 1.18
• Java: Java >= 11, Maven or Gradle

If you intend to use one of Deepgram’s SDKs to make your request, you must install it.

Open your terminal, navigate to the location on your drive where you want to create your project, and install the Deepgram SDK.

# Install the Deepgram Python SDK
# https://github.com/deepgram/deepgram-python-sdk
pip install deepgram-sdk

Continue on to one of our Getting Started Guides where you will find language-specific code samples that show you how to make requests to Deepgram with the SDK of your choice.

• Pre-Recorded Speech to Text
• Streaming Speech to Text
• Text to Speech
• Audio Intelligence
• Text Intelligence

What’s Next

• Deepgram API Overview