From 28aa5c12f950c4dc9144c3826558e5aa6e8624bd Mon Sep 17 00:00:00 2001 From: MVS-source Date: Thu, 16 Jul 2026 15:37:08 +0200 Subject: [PATCH 1/2] docs: add Eden AI integration guides for Bifrost and Lynkr Add two new integration guides under a new "AI Gateway" nav group: - Bifrost: OpenAI-compatible LLM gateway (Custom Provider config) - Lynkr: tier-based routing gateway (built-in Eden AI provider) Both point at https://api.edenai.run/v3. Env var follows the docs house style (EDEN_AI_API_KEY) for Bifrost; Lynkr uses its derived EDENAI_API_KEY (_API_KEY convention). Includes square icon SVGs and docs.json nav entries. --- docs.json | 9 ++ integration-logo/bifrost-icondoc.svg | 3 + integration-logo/lynkr-icondoc.svg | 36 +++++++ v3/integrations/bifrost.mdx | 115 +++++++++++++++++++++++ v3/integrations/lynkr.mdx | 134 +++++++++++++++++++++++++++ 5 files changed, 297 insertions(+) create mode 100644 integration-logo/bifrost-icondoc.svg create mode 100644 integration-logo/lynkr-icondoc.svg create mode 100644 v3/integrations/bifrost.mdx create mode 100644 v3/integrations/lynkr.mdx diff --git a/docs.json b/docs.json index c24f4a7..4d21103 100644 --- a/docs.json +++ b/docs.json @@ -226,6 +226,15 @@ "v3/integrations/langchain" ] }, + { + "group": "AI Gateway", + "icon": "network-wired", + "expanded": false, + "pages": [ + "v3/integrations/bifrost", + "v3/integrations/lynkr" + ] + }, { "group": "Coding Agents", "icon": "robot", diff --git a/integration-logo/bifrost-icondoc.svg b/integration-logo/bifrost-icondoc.svg new file mode 100644 index 0000000..012c24b --- /dev/null +++ b/integration-logo/bifrost-icondoc.svg @@ -0,0 +1,3 @@ + + + diff --git a/integration-logo/lynkr-icondoc.svg b/integration-logo/lynkr-icondoc.svg new file mode 100644 index 0000000..3880524 --- /dev/null +++ b/integration-logo/lynkr-icondoc.svg @@ -0,0 +1,36 @@ + + + + + + diff --git a/v3/integrations/bifrost.mdx b/v3/integrations/bifrost.mdx new file mode 100644 index 0000000..07a75c2 --- /dev/null +++ b/v3/integrations/bifrost.mdx @@ -0,0 +1,115 @@ +--- +title: "Bifrost" +icon: "/integration-logo/bifrost-icondoc.svg" +description: "Use Bifrost with Eden AI to route to 500+ AI models through one OpenAI-compatible gateway." +--- + +import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; + + + +Use Bifrost with Eden AI to route to 500+ AI models through one OpenAI-compatible gateway. + +## Overview + +Bifrost is a high-performance open-source LLM gateway (Go) that adds routing, fallbacks, load-balancing and governance across providers. Because Eden AI is fully OpenAI-compatible, you add it through Bifrost's **Custom Provider** configuration — no build and no fork — and route to models from OpenAI, Anthropic, Google, Cohere, Meta and more behind one key, with EU-based, GDPR-aligned inference. + +## Installation + + +```bash Docker +docker run -p 8080:8080 -v $(pwd)/data:/app/data maximhq/bifrost +``` + +```bash npx +npx -y @maximhq/bifrost +``` + + +## Quick Start + +Add Eden AI as a Custom Provider in your `config.json`, then point any request at it: + + +```json config.json +{ + "providers": { + "edenai": { + "keys": [ + { "name": "edenai-key", "value": "env.EDEN_AI_API_KEY", "models": ["*"], "weight": 1.0 } + ], + "network_config": { "base_url": "https://api.edenai.run/v3" }, + "custom_provider_config": { + "base_provider_type": "openai", + "allowed_requests": { + "chat_completion": true, + "chat_completion_stream": true, + "embedding": true + } + } + } + } +} +``` + +```bash curl +curl -X POST http://localhost:8080/v1/chat/completions \ + -H "Content-Type: application/json" \ + -d '{ + "model": "edenai/openai/gpt-4o", + "messages": [{"role": "user", "content": "Hello! How are you?"}] + }' +``` + + +You can also add the provider at runtime via `POST /api/providers` or from the Bifrost web UI under **Model Providers** — no restart needed. + +## Available Models + +Call any Eden AI model through Bifrost as `edenai//`: + +**OpenAI** +- `edenai/openai/gpt-4o` +- `edenai/openai/gpt-4o-mini` + +**Anthropic** +- `edenai/anthropic/claude-sonnet-4-5` +- `edenai/anthropic/claude-haiku-4-5` + +**Google** +- `edenai/google/gemini-2.5-pro` +- `edenai/google/gemini-2.5-flash` + +**Mistral** +- `edenai/mistral/mistral-large-latest` +- `edenai/mistral/mistral-small-latest` + +## Routing & Fallbacks + +Because Eden AI is a standard Bifrost provider, it participates in Bifrost's reliability features — weighted keys, load-balancing and provider fallbacks. Add Eden AI alongside other providers and let Bifrost route or fall back to it as needed, all through the same OpenAI-compatible endpoint. + +## Environment Variables + +Bifrost reads the key referenced as `env.EDEN_AI_API_KEY` in `config.json` from the environment: + + +```bash .env +EDEN_AI_API_KEY=your_api_key_here +``` + + +## Next Steps + +- [Chat Completions](/v3/llms/chat-completions) - Core LLM endpoint +- [List LLM Models](/v3/llms/listing-models) - Browse available providers and models +- [OpenAI SDK (Python)](/v3/integrations/openai-sdk-python) - Direct SDK usage diff --git a/v3/integrations/lynkr.mdx b/v3/integrations/lynkr.mdx new file mode 100644 index 0000000..79b0fc8 --- /dev/null +++ b/v3/integrations/lynkr.mdx @@ -0,0 +1,134 @@ +--- +title: "Lynkr" +icon: "/integration-logo/lynkr-icondoc.svg" +description: "Use Lynkr with Eden AI to route your gateway to 500+ AI models with tier-based cost optimisation." +--- + +import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; + + + +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 + + +```bash npm +npm install -g lynkr +``` + +```bash Homebrew +brew tap fast-editor/lynkr +brew install lynkr +``` + +```bash Install script +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: + + +```bash Terminal +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 +``` + + +```bash 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): + + +```bash .env +EDENAI_API_KEY=your-edenai-key +EDENAI_MODEL=openai/gpt-4o-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: + + +```bash Static +export MODEL_PROVIDER=edenai +``` + + +**Tier-based (recommended for cost)** — set all four tiers to Eden AI models; Lynkr routes by request complexity: + + +```bash Tier-based +export TIER_SIMPLE=edenai:mistral/mistral-small-latest +export TIER_MEDIUM=edenai:openai/gpt-4o-mini +export TIER_HARD=edenai:anthropic/claude-sonnet-4-5 +export TIER_EXPERT=edenai:openai/gpt-4o +``` + + +## Available Models + +Use the `provider/model` format for any Eden AI model: + +**OpenAI** +- `openai/gpt-4o` +- `openai/gpt-4o-mini` + +**Anthropic** +- `anthropic/claude-sonnet-4-5` +- `anthropic/claude-haiku-4-5` + +**Google** +- `google/gemini-2.5-pro` +- `google/gemini-2.5-flash` + +**Mistral** +- `mistral/mistral-large-latest` +- `mistral/mistral-small-latest` + +## Environment Variables + + +```bash .env +EDENAI_API_KEY=your_api_key_here +EDENAI_MODEL=openai/gpt-4o-mini +EDENAI_ENDPOINT=https://api.edenai.run/v3/chat/completions +``` + + +## Next Steps + +- [Chat Completions](/v3/llms/chat-completions) - Core LLM endpoint +- [List LLM Models](/v3/llms/listing-models) - Browse available providers and models +- [OpenAI SDK (Python)](/v3/integrations/openai-sdk-python) - Direct SDK usage From 5f26b093c461119733c67ea56686c9ce6812d63d Mon Sep 17 00:00:00 2001 From: MVS-source Date: Thu, 16 Jul 2026 18:04:10 +0200 Subject: [PATCH 2/2] docs: use current model IDs (gpt-5.5, claude-sonnet-5, gemini-3.5-flash, mistral-*-2512/2603) --- v3/integrations/bifrost.mdx | 14 +++++++------- v3/integrations/lynkr.mdx | 26 +++++++++++++------------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/v3/integrations/bifrost.mdx b/v3/integrations/bifrost.mdx index 07a75c2..d9be557 100644 --- a/v3/integrations/bifrost.mdx +++ b/v3/integrations/bifrost.mdx @@ -66,7 +66,7 @@ Add Eden AI as a Custom Provider in your `config.json`, then point any request a curl -X POST http://localhost:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ - "model": "edenai/openai/gpt-4o", + "model": "edenai/openai/gpt-5.5", "messages": [{"role": "user", "content": "Hello! How are you?"}] }' ``` @@ -79,20 +79,20 @@ You can also add the provider at runtime via `POST /api/providers` or from the B Call any Eden AI model through Bifrost as `edenai//`: **OpenAI** -- `edenai/openai/gpt-4o` -- `edenai/openai/gpt-4o-mini` +- `edenai/openai/gpt-5.5` +- `edenai/openai/gpt-5-mini` **Anthropic** -- `edenai/anthropic/claude-sonnet-4-5` +- `edenai/anthropic/claude-sonnet-5` - `edenai/anthropic/claude-haiku-4-5` **Google** - `edenai/google/gemini-2.5-pro` -- `edenai/google/gemini-2.5-flash` +- `edenai/google/gemini-3.5-flash` **Mistral** -- `edenai/mistral/mistral-large-latest` -- `edenai/mistral/mistral-small-latest` +- `edenai/mistral/mistral-large-2512` +- `edenai/mistral/mistral-small-2603` ## Routing & Fallbacks diff --git a/v3/integrations/lynkr.mdx b/v3/integrations/lynkr.mdx index 79b0fc8..6df25d8 100644 --- a/v3/integrations/lynkr.mdx +++ b/v3/integrations/lynkr.mdx @@ -58,7 +58,7 @@ lynkr start # OpenAI-compatible endpoint on port 8081 curl -X POST http://localhost:8081/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ - "model": "mistral/mistral-small-latest", + "model": "mistral/mistral-small-2603", "messages": [{"role": "user", "content": "Hello from Lynkr + Eden AI"}] }' ``` @@ -70,7 +70,7 @@ Lynkr reads provider credentials from environment variables (or a `.env` file): ```bash .env EDENAI_API_KEY=your-edenai-key -EDENAI_MODEL=openai/gpt-4o-mini # default model (provider/model naming) +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 ``` @@ -90,10 +90,10 @@ export MODEL_PROVIDER=edenai ```bash Tier-based -export TIER_SIMPLE=edenai:mistral/mistral-small-latest -export TIER_MEDIUM=edenai:openai/gpt-4o-mini -export TIER_HARD=edenai:anthropic/claude-sonnet-4-5 -export TIER_EXPERT=edenai:openai/gpt-4o +export TIER_SIMPLE=edenai:mistral/mistral-small-2603 +export TIER_MEDIUM=edenai:openai/gpt-5-mini +export TIER_HARD=edenai:anthropic/claude-sonnet-5 +export TIER_EXPERT=edenai:openai/gpt-5.5 ``` @@ -102,27 +102,27 @@ export TIER_EXPERT=edenai:openai/gpt-4o Use the `provider/model` format for any Eden AI model: **OpenAI** -- `openai/gpt-4o` -- `openai/gpt-4o-mini` +- `openai/gpt-5.5` +- `openai/gpt-5-mini` **Anthropic** -- `anthropic/claude-sonnet-4-5` +- `anthropic/claude-sonnet-5` - `anthropic/claude-haiku-4-5` **Google** - `google/gemini-2.5-pro` -- `google/gemini-2.5-flash` +- `google/gemini-3.5-flash` **Mistral** -- `mistral/mistral-large-latest` -- `mistral/mistral-small-latest` +- `mistral/mistral-large-2512` +- `mistral/mistral-small-2603` ## Environment Variables ```bash .env EDENAI_API_KEY=your_api_key_here -EDENAI_MODEL=openai/gpt-4o-mini +EDENAI_MODEL=openai/gpt-5-mini EDENAI_ENDPOINT=https://api.edenai.run/v3/chat/completions ```