> For the complete documentation index, see [llms.txt](https://sogni.gitbook.io/sogni-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sogni.gitbook.io/sogni-docs/sogni-intelligence/integration-open-webui.md).

# 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 Qwen3.6 35B A3B or Qwen3.5 35B A3B 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.6-35b-a3b-gguf-iq4xs`
* `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. |


---

# 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 dynamically by asking a question.

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

```
GET https://sogni.gitbook.io/sogni-docs/sogni-intelligence/integration-open-webui.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.
