Skip to main content

Every Dify app needs at least one model provider. Install a provider, add your API key, and all apps in the workspace can use its models.

Warning

API keys grant workspace-wide model access and trigger direct billing through each provider’s account. Only the workspace owner and admins can manage providers.

Add a Provider#

  1. In Integrations > Model Provider, browse the Install model providers section or visit the Marketplace for more options.

  2. After installing, click Setup on the provider card and enter your API key (and any other required credentials, such as a custom endpoint URL or organization ID). Dify validates the credentials before making the provider available.

Add a Custom Model#

A provider’s models are ready as soon as you connect it, so you only add one by hand when the model you need isn’t listed, such as a brand-new or fine-tuned model.

Click Add Model on the provider’s card, then give the model a name and its credentials. Providers that serve only a fixed set of models don’t offer this option.

Info

If the model you add matches the name and type of an existing one, Dify attaches the new key to that model instead of creating a duplicate.

Manage Your Keys#

Add more than one key to a provider when you want to keep development and production apart or spread usage across several accounts.

  • For a provider’s own models, click Configure on its card to manage the keys they share.

    Manage Credentials for a Provider's Models

  • For a custom model you added, click Configure on that model to manage its own keys.

    Custom Model Configuration

    Custom Model Credentials

    Warning

    A custom model relies on its own keys. Deleting its only key removes the model too.

    To view every custom model’s keys in one place, click Manage Credentials on the provider card.

    Manage Credentials for All Custom Models

    Keys stay here even after the custom model is removed, so you can re-add the model later without re-entering its keys.

    Re-add a Removed Model

Choose the Models Apps Use by Default#

Apps and nodes that don’t pick a model fall back to your workspace defaults. Click Default Models at the top-right corner to set one for each job:

  • System Reasoning Model: the default for general LLM tasks.
  • Embedding Model: indexes and retrieves knowledge base content.
  • Rerank Model: reorders retrieval results by relevance.
  • Speech-to-Text Model: turns audio into text.
  • Text-to-Speech Model: turns text into audio.