Skip to main content

Configure BYOK for dbt Wizard in dbt platform

Use bring-your-own-key (BYOK) to connect dbt Wizard or dbt Copilot in dbt platform to your own AI provider account instead of using dbt Labs' managed infrastructure.

The following BYOK instructions apply to dbt platform only. For CLI BYOK setup, refer to Configure BYOK for dbt Wizard.

When you configure a provider with your own key, usage costs appear on your provider account instead of your dbt Labs account, and token costs are billed by whichever provider you choose.

If you'd rather skip that upkeep, the dbt Labs-managed option is ready to use with no setup, and comes with trial and monthly usage credits.

Prerequisites

  • A dbt platform account on any plan — BYOK is available on Developer, Starter, Enterprise, and Enterprise+ plans
  • dbt admin permissions to enable AI features and configure providers in Account settings
  • An API key or credentials for your supported AI provider
 See the full list of supported AI providers

dbt Wizard supports managed models (billed by dbt Labs, no key to manage) and bring-your-own-key (BYOK) models (billed directly by your provider).

Here are the following AI providers supported depending on where you work. Refer to Model Provider Rate table for the full list of available models.

ProviderAccess
OpenAI (default)dbt managed or BYOK
Anthropicdbt managed or BYOK
Open weight models (like DeepSeek, Kimi, and so on).dbt managed
Azure AI Foundry / Azure OpenAIBYOK

†Anthropic enterprise and subscription licenses (such as Claude Enterprise) aren't supported per Anthropic's terms of service.

dbt Copilot

dbt Copilot supports different AI providers, including bring your own key (BYOK) on any plan:

  • dbt Labs-managed OpenAI API key
  • BYOK OpenAI API key
  • BYOK Azure OpenAI API key

Snowflake Cortex, AWS Bedrock, Azure AI Foundry, and Anthropic aren't supported for dbt Copilot.

Configure AI provider

A dbt platform account on any plan can use a dbt managed provider to get started right away or configure a custom AI provider by BYOK. If you use BYOK, you will incur API calls and associated charges from that provider.

The following instructions explain how to configure a dbt Labs managed or BYOK AI provider for dbt Wizard. dbt managed AI providers are administered by dbt Labs and don’t require a user-provided API key. The AI providers shown in Account settings may change as dbt Labs adds managed models. For the current list of models and providers, refer to the Model Provider Rate table.

To configure a provider:

  1. Click your account name and select Account settings in the side menu.
  2. Under Settings, click AI features.
  3. Under AI providers, click Edit to configure the AI integration.
  4. For each provider, select your Key management option from the dropdown, then follow these steps for your provider below.

Managed by dbt Labs

Use this option as a managed alternative to the default OpenAI model.

  1. Unless not selected, select dbt Labs from the list to use dbt Labs' managed Anthropic key.
  2. Click Save.

Managed by you (BYOK)

  1. Select Anthropic from the options.
  2. Enter your Anthropic API key.
  3. Click Save.
Embedding limitations

When using an Anthropic API key, dbt continues to use the dbt Labs-managed OpenAI key for embeddings in text_to_sql MCP tools, since Anthropic doesn't natively provide embeddings.

Was this page helpful?

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

0
Loading