# Providers

#### Connect and manage your AI model providers

The Providers section allows you to use your own LLM API tokens (like OpenAI, Anthropic, and Gemini) in Zaia Endless to avoid using workspace credits.

### 🔹 OpenAI (GPT-4, GPT-4o, etc.)

#### **Steps:**

1. Create or log in to your OpenAI account at the [OpenAI Platform](https://platform.openai.com/).
2. Navigate to the [creation key page](https://platform.openai.com/api-keys).
3. Click the `+ Create new secret key` button in the top-right corner
4. Give your key a descriptive name.
   1. Optional → Select a specific project to restrict the key.
5. Click `Create secret key`.
6. Copy your key, save it in a secure location, and add it as a Provider in Zaia.

{% hint style="info" %}
⚠️ **Important:**\
Copy the key immediately. This is the only time you will see the full secret key.
{% endhint %}

***

#### 🔹 **Anthropic (Claude)**

#### **Steps:**

1. Create or log in to your account at the [Claude Platform](https://platform.claude.com).
2. Click the `+ Create key` button in the top-right corner.
3. Give your key a descriptive name.
   1. Optional → Select a specific workspace to restrict the key.
4. Click  `Add`.
5. Click `Copy Key` .
6. Copy your key, save it in a secure location, and add it as a Provider in Zaia.

{% hint style="info" %}
&#x20;⚠️ **Important:**\
Copy the key immediately. This is the only time you will see the full secret key.
{% endhint %}

***

### 🔹 **Google Gemini (Google AI Studio)**

#### **Steps:**

1. Create or log in to your Google account at [Google AI Studio](https://aistudio.google.com/app/)
2. Click on `Get API Key` in the bottom-left sidebar.
3. Click the `Create API key` button in the top-right corner.
4. Give your key a descriptive name.
   1. Optional → Select a specific project to restrict the key.
5. Click `Create API key`.
6. Copy your key, save it in a secure location, and add it as a Provider in Zaia.

{% hint style="info" %}
💡 Note:\
Google allows you to view your existing keys at any time in the AI Studio dashboard.
{% endhint %}

***

### **4. OpenRouter (Soon)**

#### **Steps:**

1. Create or log in to your OpenRouter at [Open Router](https://openrouter.ai/)
2. Click `Get API Key` .
3. Click `Create` .
4. Give your key a descriptive name.
   1. Credit limit (optional): Configure a spending limit for this key.
   2. Reset limit every...: Configure how often the credits reset.
   3. Expiration: Set an automatic expiration date for the key.
5. Click `Create` .
6. Copy your key, save it in a secure location, and add it as a Provider in Zaia.

{% hint style="info" %}
&#x20;⚠️ **Important:**\
Copy the key immediately. This is the only time you will see the full secret key.
{% endhint %}

***

### How to configure your provider inside Zaia Endless

You can configure your provider key within Zaia Endless in two ways: via the **Workspace Settings** under the **Integrations** section or page or on **Agent Instructions Page**.

### Option 1: Through Main Workspace page

#### **Steps:**

1. Once logged in, click the workspace selector in the top-left corner.
   1. Click the **cog icon** (Settings) next to your workspace name.
2. In the `Integrations` section, click the `Providers` button.
3. Click the `+ Configure Provider` button.

### Option 2: Through an Agent page

#### **Steps:**

1. Once logged in, click `Builder` in the left-hand main menu.
2. Select an existing agent or click to create a new one.
3. Within the agent configuration, locate the Provider section.
4. Click `Configure Provider +` button.

### Configure the Provider

Regardless of the path you chose above, the final configuration steps are the same:

#### **Steps:**

1. **Name**: Give your provider a recognizable name.
2. **Description (Optional)**: Add a brief description if needed.
3. **Select Provider**: Choose your desired provider from the list.
4. **Provider Token**: Enter your specific provider API token/key.
5. Click in `create` to save your settings.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zaia.app/settings/providers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
