# Integration-open-webui

## Open WebUI Integration

[Open WebUI](https://openwebui.com/) is a self-hosted web interface for LLMs. Because SogniLLM is OpenAI API-compatible, you can add it as a provider in Open WebUI and start chatting with Sogni's Qwen 3.5 models directly from the browser.

***

### Prerequisites

* **Open WebUI** installed and running (see the [Open WebUI docs](https://docs.openwebui.com/) for setup)
* A **Sogni API key** (get one free at [app.sogni.ai](https://app.sogni.ai))

***

### Setup

#### Step 1: Add SogniLLM as a Connection

1. Open the **Admin Panel** in Open WebUI
2. Go to **Settings** > **Connections**
3. In the **OpenAI API** section, click **+** to add a new connection
4. Enter the following:

| Field       | Value                     |
| ----------- | ------------------------- |
| **URL**     | `https://api.sogni.ai/v1` |
| **API Key** | Your Sogni API key        |

5. Click **Save**

#### Step 2: Verify Models Load

After saving, go to the **chat interface** and click the **model selector** dropdown. You should see:

* `qwen3.5-35b-a3b-gguf-q4km`
* `qwen3.5-35b-a3b-abliterated-gguf-q4km`

{% hint style="warning" %}
If no models appear, double-check that:

* The URL includes the `/v1` suffix
* Your API key is correct and active
* Your account has a token balance (free starter tokens are included on signup)
  {% endhint %}

#### Step 3: Start Chatting

Select a Sogni model from the dropdown and send a message. Responses stream in real time.

***

### Important Notes

{% hint style="info" %}
**Billing** — SogniLLM is billed in Spark or SOGNI tokens, not USD. You get free starter tokens when you sign up, and you can claim a daily bonus. See Supernet & Rewards for details.
{% endhint %}

***

### Troubleshooting

| Issue                           | Solution                                                                                                                    |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Models don't appear in dropdown | Verify the URL is exactly `https://api.sogni.ai/v1` (with `/v1`). Check your API key.                                       |
| `401 authentication_error`      | Your API key is invalid or expired. Generate a new one at app.sogni.ai.                                                     |
| `402 insufficient_quota`        | Your token balance is empty. Claim your daily bonus or purchase tokens.                                                     |
| Responses are slow or timeout   | The Supernet routes your request to available GPU workers. During peak usage, there may be brief delays. Try again shortly. |
