Dify integration guide

Overview

Dify manages external models through Workspace Model Provider. A self-hosted instance may need the OpenAI API-compatible plugin before credentials and models can be added.

Quick configuration

Dify’s OpenAI API-compatible provider uses this endpoint.

Provider: OpenAI-API-compatible
Endpoint URL: https://api.moloop.io/v1
API Key: YOUR_API_KEY
Model name: YOUR_MODEL_ID

• Create an API key

Compatibility

• LLM / Chat

• Streaming

• Tool calling (model and app dependent)

Step-by-step setup

Open Model Provider

As a workspace administrator, open Settings > Model Provider.

Choose the compatible provider

Find or install the OpenAI API-compatible provider.

Add credentials

Add credentials and enter Endpoint URL and API Key.

Endpoint URL: https://api.moloop.io/v1
API Key: YOUR_API_KEY

Add an LLM model

Add an LLM using the exact MoLoop catalog ID as Model name.

Verify in Playground

Choose the model in Playground or app debug and send a short prompt.

Recommended models

Dify registers models by type. Do not register chat, embedding, and reranking models under the same type.

• Browse the model catalog

Things to know

• Regular members may not see the provider credential form; workspace administrator access may be required.

• When a test fails, separate credential validation, model type, and Dify app orchestration.