Deepgram API

Give your agents access to Deepgram API. Bring your own Deepgram key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Deepgram logoDeepgram
Instant

Deepgram is an AI-powered speech recognition platform for accurate audio transcription and understanding. It enables fast, scalable speech-to-text with advanced audio intelligence features.

17 Tools
COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Deepgram without a separate account or API key for each one. New accounts start with $2 of free credit.

No Deepgram account or key

Your agent calls Deepgram through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.004 per audio minute for prerecorded Nova-3 English transcription, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Deepgram with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Deepgram API to your AI assistant

Use Deepgram from the AI assistant you already work in. Connect Composio once, then paste the prompt.

  1. 1

    Open the Connectors menu

    Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
    Add Composio to Claude
  2. 2

    Add the Composio MCP server

    Name it Composio, paste the MCP server URL and click Add.
    https://connect.composio.dev/mcp
  3. 3

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  4. 4

    Paste the prompt

    Start a new chat and paste the prompt. Claude runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
    Install in ChatGPT
  2. 2

    Authorize in your browser

    Connect the plugin, then sign in to Composio to approve the connection.
  3. 3

    Turn on Composio in your chat

    In a new chat, click +, then More, and select Composio.
  4. 4

    Paste the prompt

    Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
    Install in Cursor
  2. 2

    Paste the prompt

    Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
  1. 1

    Add the Composio plugin

    Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
    Add to Grok Bot
  2. 2

    Authenticate

    Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
  3. 3

    Paste the prompt

    Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
  1. 1

    Paste the setup prompt

    Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
    Set up Composio from composio.dev/hermes
  2. 2

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  3. 3

    Paste the prompt

    Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
ClaudeNew chat

Paste this prompt

Use Deepgram through Composio Instant to transcribe the English speech at https://upload.wikimedia.org/wikipedia/commons/transcoded/6/6f/FDR_-_Day_of_Infamy.ogg/FDR_-_Day_of_Infamy.ogg.mp3. Return the transcript.

What success looks like

DEEPGRAM_SPEECH_TO_TEXT_PRE_RECORDED

Your assistant runs Deepgram and replies with the words spoken in the recording.

Runs on Composio Instant
SDK

Use the Deepgram API in your code

Call Deepgram from your own agent with the Composio SDK. Four steps and one tool call.

  1. 1

    Set up Composio

    Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
    export COMPOSIO_API_KEY="your_composio_api_key"
  2. 2

    Install the SDK

    The Python SDK needs Python 3.11 through 3.15.
    pip install composio
  3. 3

    Run the call

    Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
    DEEPGRAM_SPEECH_TO_TEXT_PRE_RECORDED
  4. 4

    Read the response

    When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
agent.py
from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["deepgram"],
    instant={
        "toolkits": {"enable": ["deepgram"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "DEEPGRAM_SPEECH_TO_TEXT_PRE_RECORDED",
    arguments={
        "model": "nova-3",
        "language": "en-US",
        "audio_url": "https://upload.wikimedia.org/wikipedia/commons/transcoded/6/6f/FDR_-_Day_of_Infamy.ogg/FDR_-_Day_of_Infamy.ogg.mp3",
        "punctuate": True,
        "content_type": "audio/mpeg",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)
TOOLS

Available Deepgram API tools

5 Deepgram tools run on Instant, priced per call with no Deepgram key. Tools marked Your key need your own Deepgram account.

ActionTool slugWhat it doesAvailability
Transcribe AudioDEEPGRAM_SPEECH_TO_TEXT_PRE_RECORDEDTurn pre-recorded audio from a public URL into a transcript.
Instant$0.004 per audio minute for prerecorded Nova-3 English transcription10% off
Generate SpeechDEEPGRAM_TEXT_TO_SPEECH_RESTConvert text into base64-encoded audio.
Instant$0.03 per 1,000 Aura-2 characters10% off
Get Model by IDDEEPGRAM_GET_MODELRetrieve metadata for a specific Deepgram model by its UUID.
Instant$0 per request
Get Public ModelsDEEPGRAM_GET_MODELSRetrieve metadata on all public Deepgram models (speech-to-text and text-to-speech).
Instant$0 per request
List Think ModelsDEEPGRAM_LIST_THINK_MODELSTool to list available think models for AI agent processing and voice agent configuration.
Instant$0 per request
Get Request LogDEEPGRAM_GET_PROJECT_REQUESTRetrieve a request log for a Deepgram project by ID.Your key
List ProjectsDEEPGRAM_GET_PROJECTSList Deepgram projects accessible to your API key.Your key

Instant prices are Deepgram's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Deepgram API use cases and example prompts

Copy a prompt into your agent. Each one uses Deepgram with apps you connect through Composio.

  • Save customer interview transcripts

    Use Deepgram to transcribe the public audio link for the latest customer interview in my Research Recordings folder in Google Drive. Save the transcript in that folder as a text file.

    Apps used: Deepgram, Google Drive

  • Document product feedback calls

    Use Deepgram to transcribe the public audio link on my Product Feedback page in Notion. Add the transcript to that page under a heading with the recording title.

    Apps used: Deepgram, Notion

  • Capture meeting decisions

    Use Deepgram to transcribe the public meeting recording link in Slack's #product channel. Add the transcript and a list of decisions from the meeting to my Meeting Notes tracker in Google Sheets.

    Apps used: Deepgram, Slack, Google Sheets

  • Prepare a launch voiceover

    Use Deepgram to convert the approved voiceover script in my Product Launch Brief in Google Docs into base64-encoded audio. Post the generated audio data in Slack's #launch channel.

    Apps used: Deepgram, Google Docs, Slack

TROUBLESHOOTING

Deepgram API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Start with Deepgram.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Deepgram tool your agent needs.Free to start.

Start building