> For the complete documentation index, see [llms.txt](https://docs.ninox.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ninox.com/builder-hub/manage-your-organization-and-workspace/manage-your-organization/use-your-individual-ai-provider.md).

# Use your individual AI provider

Use your own AI provider and choose models for the Ninox AI chat.

Use your own provider account for Ninox AI by adding a provider API key. You control which provider models can be selected by users of your organization. The use of your own provider account also helps you save Ninox AI credits.

{% hint style="info" %}

#### When Ninox AI credits are still used

Your individual provider applies to the models selected for the Ninox AI chat. Ninox AI credits are still used for:

* Field suggestions while creating or editing tables.
* AI-generated sample data from the AI panel or during template installation.
* AI-generated sample data during onboarding.
* Ninox Scripts that use `generateText()` or `generateObject()`.
  {% endhint %}

{% hint style="info" %}
Only Organization Admins can connect AI providers, add or delete API keys, and choose available models.
{% endhint %}

### Understand the AI providers list

Organization Admins access the **AI providers** screen from **Settings**. Under **ORGANIZATION**, select **AI**.

The screen shows each available provider and its configuration status.

<figure><img src="https://3739718108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYwCp7NT87JGgngrkhfHT%2Fuploads%2FfoWjBtKy3Ar9RQsZSLsN%2FAI%20Providers%20EN.png?alt=media&amp;token=e68770c0-738b-450a-84e0-b51e157c7a2e" alt=""><figcaption></figcaption></figure>

Each provider row includes:

* **Provider**, which identifies the AI provider.
* **Status**, which shows whether the provider is connected. **Active** means a working API key is stored. **Not connected** means no working API key is stored.
* **API key**, which shows whether Ninox has an API key for the provider. For a stored key, only the final four characters are displayed.
* **Models**, which shows the models available in the Ninox AI chat. **No models** means no models are selected.
* **Updated**, which shows when the provider configuration last changed.

To connect a provider with the status **Not connected**, select its row and follow the steps below to add an API key and select models for the Ninox AI chat. A provider with the status **Active** already has a working API key.

### Connect your AI provider

Connect a provider by adding its API key and selecting the models your organization can use.

{% stepper %}
{% step %}

#### Open the AI screen

In **Settings**, select **AI** under **ORGANIZATION**.
{% endstep %}

{% step %}

#### Select a provider

Click the row of the provider you want to connect, such as Anthropic, OpenAI, or OpenRouter.

{% hint style="info" %}
Do not confuse the row with the checkbox. The checkbox is only available after you connect the provider and lets you [manage selected providers](#manage-selected-providers) in bulk.
{% endhint %}
{% endstep %}

{% step %}

#### Create or copy an API key

Create an API key in your provider account if you do not have one.

Use **Create an API key in the \[provider] console** to open the provider's API key setup page.
{% endstep %}

{% step %}

#### Add the API key

Paste the key into **API KEY**, then select **Save API key**.

Ninox stores the key securely. After saving, it only shows the final four characters.
{% endstep %}

{% step %}

#### Select models

Select the models that users can choose in the Ninox AI chat.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
When you add your own API key, the selected provider charges usage to your provider account. It does not use Ninox AI credits for that provider.
{% endhint %}

### Manage provider settings

Select an **Active** provider in the **AI providers** list to manage its API key, available models, and configuration details.

<figure><img src="https://3739718108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYwCp7NT87JGgngrkhfHT%2Fuploads%2FP6v1Gua5zFDKZ2Z9hmp6%2FProvider%20settings%20EN.png?alt=media&amp;token=1132f1e1-1fac-4819-9f57-7f2c604ac997" alt=""><figcaption></figcaption></figure>

The **API KEY** section shows the final four characters of the stored key.

* Select **Replace API key** to add a new key.
* Select **Delete API key** to disconnect the provider.

Under **MODELS**, select the models that users can choose in the Ninox AI chat. The panel shows how many models are available to users.

<figure><img src="https://3739718108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYwCp7NT87JGgngrkhfHT%2Fuploads%2F54LjgdEx2cDS6nhYIoLe%2FProvider%20List%20Ninox%20AI%20Chat%20EN.png?alt=media&amp;token=e4e0bd38-fbc6-412f-83e1-fdd6f6f68d32" alt=""><figcaption></figcaption></figure>

Only selected models appear in the model list. The API key remains stored if you deselect every model. You can select models again later without adding the key again.

{% hint style="info" %}
Provided models are available to everyone in the organization when enabled. Review the selected models regularly to keep the model choice aligned with your security, performance, and cost requirements.
{% endhint %}

The **DETAILS** section shows:

* **Billed to**, which identifies the account charged for provider usage.
* **Available to**, which shows who can use the provider's models.
* **Added**, which shows when and by whom the provider was configured.
* **Last changed**, which shows when and by whom the configuration was last updated.

### Manage selected providers

You can manage API keys and model access for one provider in its settings. To apply the same action to several providers, select their checkboxes in the **AI providers** list.

<figure><img src="https://3739718108-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYwCp7NT87JGgngrkhfHT%2Fuploads%2Flyt42MNUAsxwrFqAr5UD%2FAI%20providers%20selected%20EN.png?alt=media&amp;token=d5b1238d-a3cf-4889-9ca2-38a6f26b4ff1" alt=""><figcaption></figcaption></figure>

The available actions apply to every selected provider:

* **Deselect all models** removes every selected provider's models from the Ninox AI chat. Their API keys remain stored, so you can select models again later.
* **Delete API key** removes the stored API keys for the selected providers and disconnects them.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.ninox.com/builder-hub/manage-your-organization-and-workspace/manage-your-organization/use-your-individual-ai-provider.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
