Create a Deepgram API Key

Last updated 09/14/2021

Each time you use Deepgram's API, you'll need to authenticate using an API Key.

In this guide, you'll learn how to create an API Key using the Deepgram Console. We will also show you how to use your new API Key to authenticate with Deepgram's API.

Before You Begin

Before you can use Deepgram products, you'll need to create a Deepgram account. Signup is free and includes:

  • $150 in credit, which gives you access to:
    • all base models
    • pre-recorded and streaming functionality
    • all features

Add an API Key

API Keys enable you to use the Deepgram API and are associated with Deepgram Projects, which organize all of your Deepgram resources and consist of a set of users, a set of API Keys, and billing and monitoring settings. When you create an API Key, you assign it a Role, which determines which actions it can be used to perform in the associated Project.

When you sign up, we automatically create a Project for you. Any promotional credit you have earned is attached to this first project. If you would like to transfer your promotional balance to a new project, send a support request to our Product Team.



To change a project's name:

  1. Log in to the Deepgram Console.

  2. Locate the Projects section of the Dashboard, select the project you want to rename, and then select Settings.

    Console - Navigate to first project settings
  3. Enter a new Project Name for your project, and select Update.

    Console - Update project name

To create a new project:

  1. Log in to the Deepgram Console.

  2. Locate the Projects section of the Dashboard, and select the + icon.

    Console - Create project
  3. Enter a New Project Name, and select Create Project.

    Console - Enter project name

    Once the project is created, it will appear in the navigation under Projects.



  1. Log in to the Deepgram Console.

  2. Locate the Projects section, select the Project to which you want to add an API Key, and then select Settings.

    Console - View project settings
  3. Select the API Keys view.

    Console - View API keys
  4. Select Create a New API Key.

    Console - Create new key
  5. Enter the following settings, and select Create Key:

    NameDescription
    Friendly API Key NameName to remember in case you need to retrieve the API Key later using the Deepgram API.
    RoleRole to assign to the API Key. The API Key may perform only the actions allowed by the permissions associated with this role. To learn more about roles, see Working with Roles.


    Console - Enter settings
  6. Copy the key and save it somewhere safe, then select Got it. For security reasons, we won't be able to show you the key again.

    Console - Copy key

Use the API Key

Now that you have an API Key, you can use it as credentials to call our API.

Transcribe a Remote File

To transcribe audio from a publicly-accessible remote file (e.g., hosted in AWS S3 or another server), you would run the following in a terminal or your favorite API client.

Be sure to replace the placeholder YOUR_DEEPGRAM_API_KEY with your Deepgram API Key.

curl \
  --request POST \
  --url 'https://api.deepgram.com/v1/listen' \
  --header 'content-type: application/json' \
  --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \
  --data '{"url":"https://static.deepgram.com/examples/interview_speech-analytics.wav"}'

To transcribe from a local file

Transcribe a Local File

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

Be sure to replace the placeholder YOUR_DEEPGRAM_API_KEY with your Deepgram API Key.

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'