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.
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.
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
    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.
Last modified on July 2, 2026