> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aigmented.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Uwierzytelnianie

> Klucze API, role i limity tokenów

## Klucze API

Wszystkie requesty API wymagają tokenu Bearer w nagłówku `Authorization`:

```bash theme={null}
Authorization: Bearer sk-TWOJ_KLUCZ_API
```

Klucze API zaczynają się od `sk-` i tworzy się je w [Panelu](https://aigmented.io) w Ustawienia → Klucze API.

<Warning>
  Klucze API są pokazywane tylko raz przy tworzeniu. Przechowuj je bezpiecznie.
</Warning>

## Wymagana rola

Dostęp do API wymaga roli **Moderator** lub wyższej w zespole. Użytkownicy z rolą `USER` otrzymają odpowiedź `403 Forbidden`.

| Rola          | Dostęp do API |
| ------------- | ------------- |
| User          | Nie           |
| Moderator     | Tak           |
| Administrator | Tak           |

## Limity tokenów

Każde wywołanie API zużywa tokeny z subskrypcji zespołu. System egzekwuje limity:

* **Przed każdym requestem:** Sprawdzana jest dostępność tokenów
* **Po każdym requestem:** Rzeczywiste zużycie jest śledzone i odliczane

Gdy limit tokenów zostanie przekroczony, API zwraca `429 Too Many Requests`:

```json theme={null}
{
  "error": "Token limit exceeded",
  "remaining": 0,
  "reason": "Monthly token quota exhausted"
}
```

## Kody błędów

| Status                  | Znaczenie                                                 |
| ----------------------- | --------------------------------------------------------- |
| `401 Unauthorized`      | Brakujący lub nieprawidłowy klucz API                     |
| `403 Forbidden`         | Niewystarczająca rola użytkownika (wymagany Moderator+)   |
| `404 Not Found`         | Kolekcja nie znaleziona lub nie należy do Twojego zespołu |
| `429 Too Many Requests` | Przekroczony limit tokenów                                |