> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oasm.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect a model

> Connect an AI provider with your own API key, choose its model, set your default, and fix connection problems

AI Studio runs on a model from an AI provider that you connect with your own API key. Until you connect one, AI Studio shows **Connect an AI Provider** instead of the chat, and nothing else in AI Studio works.

Connections are personal: each member connects their own providers in each workspace, and nobody else can see or use your key. Connecting a provider needs the `agent.write` permission.

## Supported providers

| Provider | What you need | Models offered |
| - | - | - |
| **OpenAI** | API key | GPT and o-series models (IDs starting with `gpt-`, `o1`, `o3` or `o4`) |
| **Anthropic** | API key | Claude models |
| **Google Gemini** | API key | Gemini models |
| **Open Router** | API key | Models that support tool calling |
| **OrcaRouter** | API key | Chat models served over an OpenAI-compatible API |
| **Vercel AI Gateway** | API key | Every model the gateway lists |
| **DeepSeek** | API key | Every model DeepSeek lists |
| **Kilo Gateway** | API key | Every model the gateway lists |
| **OpenCode Go** | API key | Chat models OpenCode Go lists |
| **Custom provider (OpenAI-compatible)** | **API Endpoint** (base URL), and an API key if your endpoint needs one | Every model your endpoint lists |

The model list is fetched from the provider, so new models appear without an OASM update.

The custom provider works with any server that implements the OpenAI chat completions API, such as a self-hosted inference server or a gateway in front of your own models. OASM calls `<API Endpoint>/models` to list its models and sends chat requests to the same base URL.

![Agent settings Providers section showing a connected Custom provider (OpenAI-compatible) with a default badge and a Connected button, followed by Connect buttons for OpenAI, Anthropic, Google Gemini, Open Router, OrcaRouter, Vercel AI Gateway, DeepSeek, Kilo Gateway, OpenCode Go and Custom provider (OpenAI-compatible)](https://mintcdn.com/oasmplatform/JcAER2Ib37AN8_8A/images/screens/ai-providers.webp?fit=max\&auto=format\&n=JcAER2Ib37AN8_8A\&q=85\&s=e12c4e2ea8d46ffa6c15c5d339f7439f)

Settings → Providers: one connected provider marked as the default, and every provider ready to connect

## Connect a provider

**1. Open the provider settings**

In AI Studio, click **Settings** in the sidebar. The settings dialog opens on **Providers**. You can also click **Connect** on the **Connect an AI Provider** screen, **Connect LLM** in the composer, or the gear button next to the model picker.

**2. Pick a provider**

Click **Connect** next to the provider. The **Connect \<provider>** dialog opens.

**3. Fill in the form**

* **Name**: a friendly name to identify this connection later. It starts as the provider's name; change it to something like "My Work Key" if you connect the same provider more than once.
* **API Endpoint**: only for **Custom provider (OpenAI-compatible)**. The base URL of the provider's API, for example `https://api.myprovider.com/v1`.
* **API Key**: required (marked with `*`) for every provider except the custom one, where the form marks it as optional.

**4. Click Connect**

OASM checks the key by fetching the provider's model list. If that works, you see **Provider connected successfully** and the connection appears at the top of the list with a **Connected** button. If it fails, the dialog stays open with the error; see [Troubleshooting](#troubleshooting).

![Connect OpenAI dialog with a Name field prefilled with OpenAI and the hint A friendly name to identify this configuration later, a required API Key field with the hint Required. Your API key is stored securely and never shared, and Cancel and Connect buttons](https://mintcdn.com/oasmplatform/JcAER2Ib37AN8_8A/images/screens/ai-provider-connect.webp?fit=max\&auto=format\&n=JcAER2Ib37AN8_8A\&q=85\&s=cb95552bed793ce233e1d2447c5076bd)

The Connect OpenAI dialog

A new connection starts on the first model in its list, sorted by name. Your first connection also becomes your **default**: new chats use it.

## Choose the model of a connection

Each connection has one model: the one the composer shows when that connection is your default.

**1. Expand the connection**

In **Settings → Providers**, click **Connected** on the connection. Its row shows the name and current model, for example `My Work Key · gpt-5`.

**2. Pick a model**

Open **Model**, type to search, and pick a model. The list loads from the provider (**Loading models...** while it does). You see **Model updated**.

![The connected Custom provider (OpenAI-compatible) expanded below its Connected button, showing a Model selector set to auto, a highlighted Default button with a star, and a Disconnect button](https://mintcdn.com/oasmplatform/JcAER2Ib37AN8_8A/images/screens/ai-provider-manage.webp?fit=max\&auto=format\&n=JcAER2Ib37AN8_8A\&q=85\&s=f38cc211242c1ed58bbc6923d44f5513)

A connected provider expanded: its model, the Default badge and Disconnect

If the connection is your default, the model you pick here also becomes your **Default Model** in [Models](https://docs.oasm.io/ai-studio/settings/models.md).

OASM caches each connection's model list for up to an hour, so a model the provider has just released can take up to an hour to appear.

## Set the default

Your default connection and its model run every new chat, and also power AI features outside AI Studio, such as [AI analysis](https://docs.oasm.io/vulnerability.md#ai-analysis) of a vulnerability and AI tag suggestions on [services](https://docs.oasm.io/asset.md).

To change it, expand a connection and click **Set as Default**. The button changes to **Default**, a **default** badge appears next to the provider name, and you see **Default model updated**.

You can also change the default by picking a model under **Default Model** in [Settings → Models](https://docs.oasm.io/ai-studio/settings/models.md). Both controls change the same setting.

## Connect several providers

The provider list always offers **Connect** for every provider, including ones you have already connected, so you can:

* Connect different providers, for example one hosted provider and one custom endpoint.
* Connect the same provider more than once with different keys, telling them apart by **Name**.

Connected providers are listed first, oldest first. Only one is the default at a time. Use the others by making them the default, or by picking one of their models as the **Subagent Model** in [Models](https://docs.oasm.io/ai-studio/settings/models.md), where the model picker groups models by connection.

## Switch model and reasoning effort in a chat

The composer shows a **model picker** and a **reasoning effort** picker.

**1. Pick a model**

Open the model picker next to the composer and pick a model. It lists the models of your default connection, with search. The next message uses that model.

**2. Pick a reasoning effort**

Open the effort picker (it shows **Default** until you pick a level) and choose a level. The levels are the ones the selected model publishes, such as **Minimal**, **Low**, **Medium**, **High**, **Extra high** or **Max**; for a model that publishes none, **Low**, **Medium** and **High**.

Both choices are saved on the connection, not only on the conversation:

* A model picked in the composer becomes the connection's model, and therefore your default model for new chats too.
* The effort you pick applies to that connection's model. **Default** means your **Default Reasoning Effort** from [Models](https://docs.oasm.io/ai-studio/settings/models.md), or the provider's own default when that is not set. If a model does not offer the level you picked, it runs at the provider default.

To chat with a model from another connection, make that connection the default first.

## Disconnect a provider

Expand the connection and click **Disconnect**. There is no confirmation step; you see **Disconnected successfully**.

Disconnecting:

* Deletes the connection and its stored API key.
* Removes the connection from your **Default Model**, **Small Model** and **Subagent Model** settings. If it was your default, the oldest remaining connection becomes the default.
* Stops its conversations from continuing: sending a new message in a conversation that was started with the disconnected connection fails with `LLM config not found`. Start a new chat instead.

To rotate a key, disconnect the connection and connect it again with the new key.

## With no provider connected

* AI Studio shows **Connect an AI Provider** with a **Connect** button instead of the chat.
* The composer shows **Connect LLM** instead of the model picker.
* **Settings → Models** shows "Connect an LLM provider to choose the models the agent uses." with a **Connect a provider** button.
* [AI analysis](https://docs.oasm.io/vulnerability.md#ai-analysis) of a vulnerability opens the provider settings instead of starting.
* A request that reaches the API anyway fails with `No LLM provider connected. Please connect a provider first.`

## Troubleshooting

> [accordion] Cannot connect to \<provider>: invalid API key or unable to reach the provider
>
> OASM shows this when the provider's model list comes back empty or the request fails. Check that:
>
> * The API key is correct, active and has access to the provider's models API.
> * The OASM API server can reach the provider over the internet. The request times out after 10 seconds.
> * For the providers that filter their list (see [Supported providers](#supported-providers)), your key has access to at least one model that passes the filter.
>
> For **Open Router**, OASM reads the public model list, so a wrong key is not caught when you connect. It fails later, when you send a message.

> [accordion] The custom provider does not connect
>
> For **Custom provider (OpenAI-compatible)** the same "Cannot connect" error means OASM could not list models from your endpoint. Check that:
>
> * **API Endpoint** is the base URL including any version path, such as `https://api.myprovider.com/v1`, and uses `http` or `https`. The form shows **Invalid URL format** for anything that is not a URL.
> * `GET <API Endpoint>/models` answers within 10 seconds with OpenAI-style JSON: an object whose `data` array holds models with an `id` (and optionally a `name`).
> * The endpoint answers directly. Redirects are not followed.
> * The URL does not use a private, loopback or link-local IP address (for example `127.0.0.1`, `10.x.x.x`, `172.16.x.x` to `172.31.x.x`, `192.168.x.x` or `169.254.x.x`). OASM refuses those to protect your network.

> [accordion] apiKey should not be empty
>
> The form marks the custom provider's API key as optional, but the API currently requires a value. If your endpoint does not check keys, enter any placeholder value: OASM sends it as a bearer token, which such endpoints ignore.

> [accordion] A model is missing from the list
>
> * Some providers' lists are filtered to models AI Studio can use (see [Supported providers](#supported-providers)). For example, OpenAI lists only `gpt-` and o-series models, and Open Router lists only models that support tool calling.
> * Model lists are cached for up to an hour. A model the provider has just released can take that long to appear.
> * For the custom provider, the list is exactly what your endpoint's `/models` returns.

> [accordion] The selected model does not support tool calling
>
> With **Open Router**, a chat fails with this message when the selected model cannot call tools, which the agent needs. Pick another model.

> [accordion] Failed to load providers
>
> The provider list could not be loaded from the API. Click **Retry**. If it keeps failing, check that the OASM API is running and that you have the `agent.read` permission.

## Related

> [card] [Models](https://docs.oasm.io/ai-studio/settings/models.md)
>
> Default, small and subagent models, default reasoning effort and approval mode

> [card] [Chat](https://docs.oasm.io/ai-studio/chat.md)
>
> Start a conversation in Ask or Agent mode

> [card] [Usage](https://docs.oasm.io/ai-studio/usage.md)
>
> See the tokens and cost each model used

> [card] [AI Studio overview](https://docs.oasm.io/ai-studio/overview.md)
>
> What AI Studio is and how an agent task flows


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.