# OpenRouter

Connect your OpenRouter API key to run Suger's AI features on the models OpenRouter serves.

---

## Overview

OpenRouter is an AI model provider (category: AI). By connecting your own OpenRouter API key (bring-your-own-key), the models OpenRouter offers become selectable in Suger's model picker — for Insulin agents, chat, inference, and knowledge-base embeddings. API usage is billed directly by OpenRouter to your account; Suger does not charge for these models.

### Org-Level vs User-Level

- **Org-Level**: the key is shared across your organization. Its models are available to organization-level agents and to members of the org. Connecting requires an organization admin.
- **User-Level**: the key is personal to your workspace. Its models are available to your own user-level agents and personal Insulin.

---

## Create Integration

1. Navigate to the [Suger Console Integrations](https://console.suger.io/settings?tab=integrations) page.
2. Find the **OpenRouter** integration and click **Connect**.
3. Choose the level — **Organization** (shared) or **User** (personal).
4. Paste your **OpenRouter API Key** and click **Save credentials**.

Suger verifies the key with OpenRouter before storing it, so an invalid key is rejected at connect time rather than surfacing later as a failed model run.

> Generate an API key in your OpenRouter account at [openrouter.ai](https://openrouter.ai/) (**Keys**).

:::info
After connecting, open any model picker — an agent's **Default Model**, or **Insulin model settings** — and OpenRouter's models appear, with verified models grouped first and each entry attributed to OpenRouter.
:::

## Edit Integration

Editing the API key is not supported. To change the key, delete the integration and create a new one.

## Delete Integration

You can delete the OpenRouter integration at any time. This permanently removes the stored credential. Any agent pinned to an OpenRouter model then shows that model as **unavailable** with a reconnect prompt until you reconnect OpenRouter or pick another model — Suger never silently substitutes a different model.

:::info
OpenRouter serves chat/inference models. Knowledge-base embeddings use a Suger-hosted model or a connected OpenAI or Gemini provider — see [Knowledge Bases](../../insulin/knowledge-base/).
:::