> ## Documentation Index > Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt > Use this file to discover all available pages before exploring further. # Deepgram > Learn how to integrate Vantage with Deepgram to track voice AI costs by line item, model, and API key. Vantage integrates with a Deepgram project using a project API key and imports the USD costs Deepgram reports in its [billing breakdown](https://developers.deepgram.com/reference/manage/billing/breakdown/get) API. Costs are daily and broken down by the line item Deepgram bills (for example, `Nova-3 (Stream)`), the API key that incurred the charge, and the tags on that usage. Speech-to-text, text-to-speech, voice agent, and add-on charges are included when Deepgram bills them as line items. > [!NOTE] > > Vantage imports rated USD amounts only. Deepgram does not provide usage quantities for this integration, so [usage-based reporting](https://docs.vantage.sh/usage_based_reporting.md) is not available. Prepaid credit balances are not subtracted from these costs, and tax is not included. Days with no charges are not imported. ## Deepgram Permissions Vantage connects with a Deepgram project API key that has the **Admin** or **Owner** role. Both roles include the `billing:read` permission. Member keys cannot read billing and are rejected. See Deepgram's [roles and permissions](https://developers.deepgram.com/docs/working-with-roles) documentation for details. Deepgram does not offer a billing-only API key role. Admin and Owner keys can also manage the project. Vantage only reads project and billing data. It does not send speech or agent requests, change the project, or store audio, transcripts, or prompts. Each API key belongs to one Deepgram project. Create a dedicated key for Vantage. Deepgram shows a new key only once. ## Connect Your Deepgram Account ### Prerequisites * You must have a Vantage **Organization Owner** or **Integration Owner** role to add or remove this integration. See the [Role-Based Access Control](https://docs.vantage.sh/rbac.md) documentation for details. * You need access to the Deepgram project you want to connect, with permission to create an Admin or Owner API key. * [Create a free Vantage account](https://console.vantage.sh/signup), then follow the steps below to integrate Deepgram costs. > [!NOTE] > > If your organization restricts access to the provider by IP address, add the following Vantage IP addresses to your provider's allowlist: > > ### Create the Connection **Step 1** Sign in to the [Deepgram Console](https://console.deepgram.com/) and from the top menu, open the project you want to connect. **Step 2** On the left navigation, select **API keys**. **Step 3** Click **Create a new API key**. **Step 4** Enter a name, set an expiration date, and expand the **Advanced** section. Set the **Role** to **Admin** or **Owner**. Click **Create key**. **Step 5** Copy the API key. Deepgram shows new keys only once. **Step 6** From the top navigation in Vantage, click **Settings**. **Step 7** On the left navigation, select **Integrations** and then **Deepgram**. **Step 8** On the Deepgram integration page, click **Add API Key**. **Step 9** Complete the integration form: * **API Key**: Paste the Deepgram project API key. * **Description**: Enter a name that identifies this Deepgram project. This value is the **Billing Account** (Organization) in Cost Reports. **Step 10** Click **Connect Account**. Vantage checks that the key can read billing for exactly one project before it imports costs. A Member key, or a key that is not tied to a single project, will not connect. After clicking **Connect Account**, the integration status changes to **Importing**. Vantage then imports historical Deepgram costs within your account's data retention period (six months by default), subject to the history Deepgram still has for that project. See the [Integration Status](https://docs.vantage.sh/vantage_account.md#integration-status) documentation for details on these statuses. You can connect more than one Deepgram project. Each project needs its own API key and Description. A project can only be connected once. To rotate a key, remove the existing connection and connect again with the new key. Removing the connection in Vantage does not delete the API key in Deepgram. > [!NOTE] > > As soon as costs are processed, they are available on your **All Resources** Cost Report. If you remove the Deepgram integration, the costs for that project are removed from the Vantage console. ### Next Steps - Manage Workspace Access Once the import is complete and the integration status changes to **Stable**, you can select which workspaces this integration is associated with. See the [Workspaces](https://docs.vantage.sh/workspaces.md#manage-workspace-provider-integrations) documentation for information. ## Data Refresh See the [provider data refresh documentation](https://docs.vantage.sh/provider_data_refresh.md) for information on when data for each provider refreshes in Vantage. Deepgram data refreshes once daily. During the first five days of each month, Vantage also refreshes the previous month so late-arriving charges are captured. ## Deepgram Reporting Dimensions On Deepgram [Cost Reports](https://docs.vantage.sh/cost_reports.md), you can filter and group across several dimensions: * Billing Account/Organization (the Description you enter when connecting the project) * Service (the line-item label Deepgram reports, such as `Nova-3 (Stream)`, `Nova-3 (Pre-recorded)`, `Flux (Stream)`, `Keyterm Prompting`, or `Multichannel`) * Category (the request type parsed from the line item: `streaming` or `sync` when the line item includes a model, otherwise `add_on` for charges such as keyterm prompting and multichannel) * Subcategory (the deployment when Deepgram includes it, such as `hosted`) * Resource (the Deepgram API key ID) * Charge Type (`Usage`) * Tags, including Deepgram request and API key tags and [Managed AI Tags](https://docs.vantage.sh/managed_ai_tags.md) Deepgram tags are stored as-is. A tag such as `prod` or `org-phone` is both the tag key and the tag value. UUID-shaped tag strings are not imported. Vantage also writes `deepgram:deployment` when a deployment is present. Vantage applies [Managed AI Tags](https://docs.vantage.sh/managed_ai_tags.md) so you can compare Deepgram with other AI providers. For line items that include a model, Vantage writes `vntg:ai:model` (for example, `nova-3`, `nova`, `flux`, or `base`), `vntg:ai:model_provider` (`Deepgram`), and `vntg:ai:api_key_id`. Add-on line items do not have a model, so they receive `vntg:ai:api_key_id` only. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.