Integration Guide

Dify + Meridian

Route Dify AI workflows through Meridian's OpenAI-compatible API. Keep your LLM traffic private, monitored, and under your control.

Drop-in Compatible

Meridian exposes a standard /v1 endpoint. Dify sees it as any other OpenAI provider — zero code changes in your workflows.

Custom Provider

Add Meridian as a custom OpenAI provider in Dify. Set the API base to your Meridian gateway and use your Nimbus API key.

Full Observability

Every Dify LLM call flows through Meridian. Logs, rate limits, cost tracking — all in your Nimbus dashboard.

Setup Walkthrough

1

Get your Meridian API key

Head to your Nimbus dashboard and generate an API key. Your Meridian gateway endpoint is:

https://api.getnimbus.net/v1
2

Configure Dify environment

If you're self-hosting Dify, add these to your .env file:

# .env for self-hosted Dify
CUSTOM_PROVIDER_ENABLED=true
OPENAI_API_BASE=https://api.getnimbus.net/v1
OPENAI_API_KEY=sk-nimbus-xxxxxxxxxxxxxxxx

Restart Dify after updating the environment. The custom provider will be available in Model Provider settings.

3

Add Meridian as a custom OpenAI provider

In Dify Cloud or self-hosted, navigate to Settings → Model Provider → OpenAI-API-compatible. Paste this configuration:

{
  "openai_api_base": "https://api.getnimbus.net/v1",
  "openai_api_key": "sk-nimbus-xxxxxxxxxxxxxxxx",
  "models": [
    {
      "model": "gpt-4o",
      "provider_type": "openai",
      "credentials": {
        "openai_api_key": "sk-nimbus-xxxxxxxxxxxxxxxx",
        "openai_api_base": "https://api.getnimbus.net/v1"
      }
    }
  ]
}
4

Use in your Dify apps

Create or edit any Dify app. In the model selector, choose gpt-4o (Meridian). All prompts and completions now route through your Meridian gateway.

Pro tip: Set up usage alerts in your Nimbus dashboard to monitor Dify-driven LLM spend in real time.

Environment Reference

Standard OpenAI client environment variables — works with any OpenAI-compatible SDK:

OPENAI_API_BASE=https://api.getnimbus.net/v1
OPENAI_API_KEY=sk-nimbus-xxxxxxxxxxxxxxxx
OPENAI_MODEL=gpt-4o

Ready to connect Dify?

Spin up a Meridian gateway in under 60 seconds. Your first 1M tokens are on us.

Go to Dashboard