Use Lynkr with Eden AI

Use Lynkr with Eden AI to route your gateway to 500+ AI models with tier-based cost optimisation.

Overview

Lynkr is an open-source LLM gateway that cuts costs with tier-based routing — it scores each request 0–100 and sends it to the cheapest model that can handle it. Eden AI is a built-in Lynkr provider, so you reach models from OpenAI, Anthropic, Google, Mistral and 500+ more behind one key, with EU-based, GDPR-aligned inference and unified billing.

Installation

npm install -g lynkr

brew tap fast-editor/lynkr
brew install lynkr

curl -fsSL https://raw.githubusercontent.com/Fast-Editor/Lynkr/main/install.sh | bash

Quick Start

Initialise Lynkr, point it at Eden AI, and start the gateway:

lynkr init                       # scaffold a .env
export EDENAI_API_KEY=your-edenai-key
export MODEL_PROVIDER=edenai      # send all requests to Eden AI
lynkr start                       # OpenAI-compatible endpoint on port 8081

curl

curl -X POST http://localhost:8081/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral/mistral-small-latest",
    "messages": [{"role": "user", "content": "Hello from Lynkr + Eden AI"}]
  }'

Configuration

Lynkr reads provider credentials from environment variables (or a .env file):

EDENAI_API_KEY=your-edenai-key
EDENAI_MODEL=openai/gpt-5-mini                       # default model (provider/model naming)
EDENAI_EMBEDDINGS_MODEL=openai/text-embedding-ada-002
EDENAI_ENDPOINT=https://api.edenai.run/v3/chat/completions

Routing modes

Static — every request goes to Eden AI:

export MODEL_PROVIDER=edenai

Tier-based (recommended for cost) — set all four tiers to Eden AI models; Lynkr routes by request complexity:

export TIER_SIMPLE=edenai:mistral/mistral-small-latest
export TIER_MEDIUM=edenai:openai/gpt-5-mini
export TIER_HARD=edenai:anthropic/claude-sonnet-latest
export TIER_EXPERT=edenai:openai/gpt-5.5

Available Models

Use the provider/model format for any Eden AI model: OpenAI

openai/gpt-5.5
openai/gpt-5-mini

Anthropic

anthropic/claude-sonnet-latest
anthropic/claude-haiku-latest

Google

vertex/gemini-2.5-pro
vertex/gemini-flash-latest

Mistral

mistral/mistral-large-latest
mistral/mistral-small-latest

Environment Variables

EDENAI_API_KEY=your_api_key_here
EDENAI_MODEL=openai/gpt-5-mini
EDENAI_ENDPOINT=https://api.edenai.run/v3/chat/completions

Next Steps

Chat Completions - Core LLM endpoint
List LLM Models - Browse available providers and models
OpenAI SDK (Python) - Direct SDK usage

V3 Documentation

Quick Start

Overview

LLMs

Expert Models

General

Organization

Data Governance

Integrations

Overview

Installation

Quick Start

Configuration

Routing modes

Available Models

Environment Variables

Next Steps

​Overview

​Installation

​Quick Start

​Configuration

​Routing modes

​Available Models

​Environment Variables

​Next Steps

Overview

Installation

Quick Start

Configuration

Routing modes

Available Models

Environment Variables

Next Steps