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

# Ustawienia AI

> Konfiguracja kluczy API i dostawców AI

## Przegląd

Hey Quiz pozwala na korzystanie z AI na dwa sposoby:

1. **Pula globalna** - korzystasz z limitów platformy
2. **Własne klucze API** - dodajesz swój klucz i nie masz limitów platformy

## Dostęp do ustawień

<Steps>
  <Step title="Przejdź do profilu">
    Kliknij swój awatar w prawym górnym rogu.
  </Step>

  <Step title="Wybierz Ustawienia">
    Z menu wybierz **"Ustawienia"**.
  </Step>

  <Step title="Przejdź do zakładki AI">
    Kliknij zakładkę **"Ustawienia AI"**.
  </Step>
</Steps>

## Pula globalna

### Jak działa?

* Hey Quiz udostępnia pulę zapytań do AI
* Korzystasz z niej bez konfiguracji
* Obowiązują limity zależne od planu

### Limity

| Plan       | Dzienne generowania |
| ---------- | ------------------- |
| Free       | 3                   |
| Basic      | 10                  |
| Pro        | 50                  |
| Enterprise | Bez limitu          |

<Info>
  Limity resetują się o północy (UTC).
</Info>

## Własne klucze API

### Dlaczego warto?

<Check>
  **Brak limitów platformy** - generuj ile chcesz
</Check>

<Check>
  **Wybór modelu** - używaj najnowszych modeli
</Check>

<Check>
  **Kontrola kosztów** - płacisz tylko za użycie
</Check>

<Check>
  **Prywatność** - bezpośrednia komunikacja z dostawcą
</Check>

### Obsługiwani dostawcy

| Dostawca       | Modele            | Strona        |
| -------------- | ----------------- | ------------- |
| **OpenRouter** | Wiele modeli      | openrouter.ai |
| **Anthropic**  | Claude 3, 3.5     | anthropic.com |
| **OpenAI**     | GPT-4, GPT-4o     | openai.com    |
| **Google**     | Gemini Pro, Ultra | ai.google.dev |
| **xAI**        | Grok              | x.ai          |
| **Mistral**    | Mistral Large     | mistral.ai    |

## Dodawanie klucza API

<Steps>
  <Step title="Uzyskaj klucz API">
    Zarejestruj się u wybranego dostawcy i wygeneruj klucz API.
  </Step>

  <Step title="Przejdź do ustawień AI">
    W Hey Quiz: Ustawienia → Ustawienia AI.
  </Step>

  <Step title="Wybierz dostawcę">
    Kliknij **"Dodaj klucz API"** i wybierz dostawcę.
  </Step>

  <Step title="Wklej klucz">
    Skopiuj klucz API i wklej go w pole.
  </Step>

  <Step title="Zapisz">
    Kliknij **"Zapisz"** - klucz zostanie zaszyfrowany.
  </Step>
</Steps>

### Gdzie znaleźć klucz API?

<AccordionGroup>
  <Accordion title="OpenRouter">
    1. Wejdź na openrouter.ai
    2. Zaloguj się / zarejestruj
    3. Przejdź do Settings → API Keys
    4. Kliknij "Create Key"
    5. Skopiuj wygenerowany klucz
  </Accordion>

  <Accordion title="Anthropic (Claude)">
    1. Wejdź na console.anthropic.com
    2. Zaloguj się / zarejestruj
    3. Przejdź do API Keys
    4. Kliknij "Create Key"
    5. Skopiuj klucz (zaczyna się od "sk-ant-")
  </Accordion>

  <Accordion title="OpenAI">
    1. Wejdź na platform.openai.com
    2. Zaloguj się / zarejestruj
    3. Przejdź do API Keys
    4. Kliknij "Create new secret key"
    5. Skopiuj klucz (zaczyna się od "sk-")
  </Accordion>

  <Accordion title="Google (Gemini)">
    1. Wejdź na ai.google.dev
    2. Zaloguj się kontem Google
    3. Przejdź do "Get API Key"
    4. Utwórz projekt i wygeneruj klucz
    5. Skopiuj klucz
  </Accordion>
</AccordionGroup>

## Bezpieczeństwo kluczy

<Info>
  **Twoje klucze są bezpieczne:**

  * Szyfrowane algorytmem AES-256
  * Przechowywane w bezpiecznej bazie danych
  * Nigdy nie są wyświetlane w pełnej formie
  * Dostępne tylko dla Ciebie
</Info>

### Dobre praktyki

<Warning>
  **Nigdy nie udostępniaj klucza API!**

  * Nie wysyłaj go mailem
  * Nie wklejaj na forach/czatach
  * Nie zapisuj w publicznych miejscach
</Warning>

## Wybór modelu

Po dodaniu klucza możesz wybrać preferowany model:

### OpenRouter

Dostęp do wielu modeli różnych dostawców:

* Claude 3.5 Sonnet
* GPT-4o
* Gemini Pro
* Llama 3
* i wiele innych

### Anthropic

| Model             | Zastosowanie                       |
| ----------------- | ---------------------------------- |
| Claude 3.5 Sonnet | Szybki, dobry stosunek jakość/cena |
| Claude 3 Opus     | Najwyższa jakość                   |
| Claude 3 Haiku    | Najtańszy, szybki                  |

### OpenAI

| Model       | Zastosowanie            |
| ----------- | ----------------------- |
| GPT-4o      | Najnowszy, multimodalny |
| GPT-4 Turbo | Szybki, dobra jakość    |
| GPT-4       | Klasyczny, stabilny     |

## Koszty

### Szacunkowe koszty generowania

| Model             | \~10 pytań | \~25 pytań |
| ----------------- | ---------- | ---------- |
| GPT-4o            | \~\$0.03   | \~\$0.07   |
| Claude 3.5 Sonnet | \~\$0.02   | \~\$0.05   |
| Gemini Pro        | \~\$0.01   | \~\$0.03   |

<Info>
  Koszty są szacunkowe i zależą od długości promptu i odpowiedzi.
</Info>

### Monitorowanie użycia

Sprawdzaj zużycie na stronie dostawcy:

* OpenAI: platform.openai.com/usage
* Anthropic: console.anthropic.com/usage
* Google: cloud.google.com/billing

## Zarządzanie kluczami

### Edycja klucza

1. Przejdź do Ustawień AI
2. Znajdź klucz do edycji
3. Kliknij ikonę edycji
4. Wprowadź nowy klucz
5. Zapisz zmiany

### Usuwanie klucza

1. Przejdź do Ustawień AI
2. Znajdź klucz do usunięcia
3. Kliknij ikonę kosza
4. Potwierdź usunięcie

<Warning>
  Po usunięciu klucza wrócisz do korzystania z puli globalnej (z limitami).
</Warning>

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="Klucz API nie działa">
    * Sprawdź czy klucz jest poprawny (skopiuj ponownie)
    * Sprawdź czy masz środki na koncie dostawcy
    * Sprawdź czy klucz nie wygasł
    * Upewnij się, że wybrałeś właściwego dostawcę
  </Accordion>

  <Accordion title="Błąd autoryzacji">
    * Klucz może być nieprawidłowy
    * Konto u dostawcy może być zablokowane
    * Sprawdź limity na koncie dostawcy
  </Accordion>

  <Accordion title="Generowanie wolne">
    * Serwery dostawcy mogą być obciążone
    * Spróbuj innego modelu
    * Sprawdź status usługi dostawcy
  </Accordion>
</AccordionGroup>

## Następne kroki

<CardGroup cols={2}>
  <Card title="Generowanie z tematu" icon="lightbulb" href="/pl/ai/generowanie">
    Utwórz quiz opisując temat
  </Card>

  <Card title="Generowanie z dokumentu" icon="file-pdf" href="/pl/ai/dokumenty">
    Prześlij plik i wygeneruj pytania
  </Card>
</CardGroup>