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.
Base URL: https://api.unorouter.com/v1
API Key: YOUR_API_KEYCompatibility
Step-by-step setup
- 1Install the UnoRouter plugin
Open Plugins, search the Marketplace for UnoRouter and install it, or install it from its marketplace page.
texthttps://marketplace.dify.ai/plugins/unorouter/unorouter - 2Add 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.
- 3Or 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.
textModel 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 - 4Set 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.