Search docs...

Start typing to search documentation

Dify
Dify

Dify Setup Guide

Add UnoRouter to Dify with the marketplace plugin or as an OpenAI-API-compatible model.

Overview

Dify offers two routes. The UnoRouter plugin needs only your key and comes with ready models. The OpenAI-API-compatible provider takes one model at a time with its own settings.

Quick Config

Paste these into the client. Your key auto-fills when signed in.

text
Base URL: https://api.unorouter.com/v1
API Key: YOUR_API_KEY

Sign in to auto-fill your API key

Compatibility

Chat CompletionsStreamingTool calling

Step-by-step setup

  1. 1
    Install the UnoRouter plugin

    Open Plugins, search the Marketplace for UnoRouter and install it, or install it from its marketplace page.

    text
    https://marketplace.dify.ai/plugins/unorouter/unorouter

    Sign in to auto-fill your API key

  2. 2
    Add your key

    Open Model Provider (under Settings or Integrations, depending on your Dify version), find UnoRouter and paste your API key. For a model that is not listed, click Add Model and enter its id.

  3. 3
    Or use OpenAI-API-compatible

    Install the OpenAI-API-compatible provider instead, click Add Model on its card and fill in these fields. Set Function Call Type to Tool Call for agents, and turn on Vision Support only for models that accept images.

    text
    Model Name: glm-5.3-flash:free
    API Key: YOUR_API_KEY
    API Base URL: https://api.unorouter.com/v1
    Model context size: 128000
    Upper bound for max tokens: 16000
    Function Call Type: Tool Call

    Sign in to auto-fill your API key

  4. 4
    Set a default model

    Under Default Models at the top right of Model Provider, pick an UnoRouter model as System Reasoning Model, then use it in your apps.

Best free models for Dify

Free models that work here. Paste any model id into the client.

Gotchas

  • Only workspace owners and admins can add model providers.
  • The OpenAI-API-compatible provider does not read the model list or detect capabilities. Add each model by hand and set its context size and features yourself.
Generate API KeyModels