# Introduction

## Sogni Intelligence

**Sogni Intelligence** is an OpenAI-compatible LLM inference service powered by the **Sogni Supernet** — a decentralized network of [GPU workers](https://docs.sogni.ai/sogni-fast-worker/about-sogni-fast-worker). It currently runs **Qwen 3.5** models and supports streaming, tool calling, and multi-turn conversations. Tool calling includes access to a powerful suite of Sogni Platform Tools with tool coverage for complex generative image, audio, and video tasks. Sogni Platform Tools currently requires the [Sogni Node / Javascript Client SDK](https://www.npmjs.com/package/@sogni-ai/sogni-client?activeTab=readme) but will be updated shortly to be fully supported by the REST API alone.

Because Sogni Intelligence follows the OpenAI Chat Completions API format, any application or tool that supports a custom OpenAI-compatible endpoint can use Sogni as a backend. Just change the **base URL** and **API key** — everything else stays the same.

***

### OpenAI API Compatibility

Sogni Intelligence implements the following OpenAI-compatible endpoints:

| Endpoint               | Method | Description                                            |
| ---------------------- | ------ | ------------------------------------------------------ |
| `/v1/chat/completions` | POST   | Create a chat completion (streaming and non-streaming) |
| `/v1/models`           | GET    | List available models                                  |
| `/v1/models/:model_id` | GET    | Get details for a specific model                       |

You can use these endpoints with the **OpenAI Python SDK**, the **OpenAI Node.js SDK**, **curl**, or any OpenAI-compatible client.

***

### Base URL

{% hint style="info" %}
**Base URL:** `https://api.sogni.ai`

All API requests go to `https://api.sogni.ai/v1/...`
{% endhint %}

***

### Available Models

| Model ID                                | Display Name                 | Context Window | Notes                                                                 |
| --------------------------------------- | ---------------------------- | -------------- | --------------------------------------------------------------------- |
| `qwen3.5-35b-a3b-gguf-q4km`             | Qwen 3.5 35B-A3B             | 64K tokens     | **Default model.** Standard Qwen 3.5 with reasoning and tool calling. |
| `qwen3.5-35b-a3b-abliterated-gguf-q4km` | Qwen 3.5 35B-A3B Abliterated | 64K tokens     | Uncensored variant.                                                   |

Use `GET /v1/models` to see the current list of available models at any time.

***

### Pricing

Sogni Intelligence usage is billed in **Spark** or **SOGNI** tokens — not USD.

|               | Rate                  |
| ------------- | --------------------- |
| Input tokens  | \~$0.30 per 1M tokens |
| Output tokens | \~$0.90 per 1M tokens |

You receive **free starter tokens** when you create an account, and you can claim a **daily bonus** in the app. See Supernet & Rewards for more details on acquiring tokens.

***

### Getting Your API Key

1. **Create a free account** at [app.sogni.ai](https://app.sogni.ai) if you haven't already.
2. **Open your Dashboard** — Go to [dashboard.sogni.ai](https://dashboard.sogni.ai) and log in. You'll land on the **Account & Wallet** tab.
3. **Go to the Developer section** — On the right-hand side of the dashboard, locate the **Developer** section and click **API Key**.
4. **Copy your API key** — A dialog will appear showing your API key (masked by default). Use the **eye icon** to reveal the full key, or the **copy icon** to copy it to your clipboard.

{% hint style="warning" %}
You can **Regenerate** your API key if it has been compromised, or **Disable** it if you no longer need access. Regenerating will invalidate your previous key — make sure to update it in all your applications.
{% endhint %}

Your API key can also be used with the **Sogni SDK** or to run a **Sogni Fast Worker**.

Include the key as a Bearer token in all requests:

```
Authorization: Bearer YOUR_API_KEY
```

{% hint style="info" %}
Make sure your account has sufficient **SOGNI** or **Spark Point** balance before making API calls. You can check your balance on the **Account & Wallet** tab and top up by purchasing SOGNI tokens directly from the dashboard.
{% endhint %}

***

### Quick Test

Verify your API key works with a simple curl request:

```bash
curl https://api.sogni.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "qwen3.5-35b-a3b-gguf-q4km",
    "messages": [
      {"role": "user", "content": "Hello! What model are you?"}
    ]
  }'
```

You should receive a JSON response with the model's reply in `choices[0].message.content`.

***

### What's Next

* **Open WebUI Integration** — Connect Sogni Intelligence to Open WebUI
* **OpenClaw Integration** — Use Sogni Intelligence as a provider in OpenClaw
