# Klucze API

> Tworzenie, zawężanie i zarządzanie kluczami do API.

Source: https://reverie.im/pl/docs/integrations/api-keys
Language: pl

Klucz API uwierzytelnia żądania do [Otwartego API](https://reverie.im/pl/docs/integrations/open-api) Reverie. Klucze mieszkają w **Ustawienia → Więcej → Klucze API** — tam też prowadzi kafelek **Otwarte API** w Labs. Może je tworzyć każde konto: nie ma wymogu poziomu ani limitu, ile ich masz.

## Tworzenie klucza \[#create-a-key]

### Naciśnij „Utwórz nowy klucz API” \[#press-create-new-api-key]

Na pustej stronie przycisk mówi **Utwórz swój pierwszy klucz API**.

### Nazwij go \[#name-it]

**Nazwa** jest wymagana, od 1 do 100 znaków. Tak klucz jest podpisany na liście i w statystykach użycia — „Głośnik w salonie”, „staging worker”.

### Wybierz globalny albo konkretną postać \[#choose-global-or-a-specific-character]

**Wybór postaci** to wybór między **Globalny (wszystkie postacie)** a **Konkretna postać**, a nie opcjonalny dodatek. Wskazana postać staje się postacią przypiętą do klucza.

### Opcjonalnie ustaw typ urządzenia i wygaśnięcie \[#optionally-set-a-device-type-and-an-expiry]

**Typ urządzenia** to dowolny tekst (`speaker`, `phone`, `iot`). **Wygasa** przyjmuje datę *i* godzinę; w tym momencie klucz sam przestaje działać.

Klucz pojawia się od razu jako `rk_` i 64 znaki szesnastkowe.

## Klucze da się podejrzeć w każdej chwili \[#keys-stay-retrievable]

Sekret nie pokazuje się tylko raz. Karta każdego klucza ma **Pokaż klucz API**, **Ukryj klucz API** i **Kopiuj klucz API**, o dowolnej porze, dopóki klucz istnieje.

> Skoro pełny sekret wciąż da się odczytać z twoich ustawień, traktuj dostęp do konta jak dostęp do klucza. Trzymaj klucz na serwerze albo w menedżerze sekretów, nigdy w systemie kontroli wersji ani w kodzie przeglądarki.

## Klucze globalne i klucze przypięte \[#global-keys-and-pinned-keys]

|                         | **Globalny (wszystkie postacie)** | **Konkretna postać**                                          |
| ----------------------- | --------------------------------- | ------------------------------------------------------------- |
| Co zwraca `GET /models` | Twoje ostatnie postacie           | Scenariusze tej postaci, a jeśli żadnego nie ma — samą postać |
| Pominięte `model`       | Spada na twoją najnowszą rozmowę  | Bierze przypiętą postać                                       |
| Krótkie ID scenariuszy  | Nigdy się nie rozwiązują          | Rozwiązują się względem przypiętej postaci                    |

## Wyłączanie, kasowanie, wymiana \[#disable-delete-rotate]

| Działanie               | Skutek                                                                  | Odwracalne |
| ----------------------- | ----------------------------------------------------------------------- | ---------- |
| Przełącznik **Aktywny** | Gdy jest wyłączony, żądania z tym kluczem są odrzucane                  | Tak        |
| **Usuń**                | Klucz zostaje zniszczony, a korzystające z niego aplikacje tracą dostęp | Nie        |

Nie ma osobnego unieważniania — wyłączenie i usunięcie to dwie możliwości.

> Usunięcia klucza nie da się cofnąć, a zabiera ono ze sobą jego przypisanie: dotychczasowy ruch przenosi się do worka **Usunięte klucze** w statystykach użycia, gdzie nie odróżnisz już, która integracja ile wydała. Jeśli historia może ci się przydać, najpierw wyłącz klucz.

Żeby wymienić klucz, utwórz następcę, wdróż go, a dopiero potem wyłącz albo usuń stary. Nie ma automatycznej wymiany ani okresu karencji po wygaśnięciu — wygasły klucz zostaje odrzucony z `api_key_expired` przy kolejnym żądaniu.

## Zakresy \[#scopes]

Klucze niosą zakresy, a okno tworzenia ich nie pokazuje. Klucz zrobiony w Ustawieniach może wywoływać punkty końcowe czatu i wyłącznie je.

Punkt końcowy importera postaci wymaga innego zakresu, a jedyny sposób na taki klucz to otworzyć **Labs → Umiejętność importowania postaci**, która tworzy go dla ciebie pod nazwą **Reverie Character Importer (Skill)**. Wywołanie importera zwykłym kluczem z ustawień zwraca 403. [Import postaci →](https://reverie.im/pl/docs/characters/import-characters)

## Statystyki użycia \[#usage-statistics]

Panel **Statystyki użycia** na tej samej stronie pokazuje **Żądania**, **Tokeny**, **Kredyty** i **Aktywne klucze**, zgrupowane według doby UTC, a pod nagłówkiem **Użycie według klucza** — rozbicie na poszczególne klucze. Filtruj po jednym kluczu albo po **Wszystkie klucze**, w oknie od 7 do 90 dni — domyślnie 30. Liczone są tylko rozmowy założone przez API.

Ten panel to jedyne miejsce, gdzie istnieje wydatek w rozbiciu na klucze. Historia kredytów zapisuje, ile kosztowała każda wiadomość, ale nie podpisuje transakcji kluczem, który ją wykonał — do porównywania integracji użyj więc tutejszych statystyk.

## Utwórz żądanie \[#build-a-request]

**Utwórz żądanie** otwiera generator: wybierasz jeden ze swoich aktywnych kluczy, wybierasz postać albo scenariusz z listy, którą ten klucz widzi, wpisujesz wiadomość, ustalasz strumieniowanie i temperaturę, a potem kopiujesz działający kod w cURL, TypeScripcie albo Pythonie.

Klucz jest używany w twojej przeglądarce wyłącznie do wczytania listy postaci. Wygenerowany kod czyta `REVERIE_API_KEY` ze środowiska, zamiast wpisywać sekret na stałe.

## Limity \[#limits]

| Limit                         | Wartość                                         |
| ----------------------------- | ----------------------------------------------- |
| Klucze na konto               | Bez limitu                                      |
| Limit zapytań na klucz        | Brak                                            |
| Pułap równoczesności na klucz | Brak                                            |
| Co naprawdę ogranicza użycie  | Twoje saldo kredytów oraz okno darmowych modeli |

## Powiązane \[#related]

* [Otwarte API](https://reverie.im/pl/docs/integrations/open-api) — punkty końcowe, kształt żądania i błędy
* [Import postaci](https://reverie.im/pl/docs/characters/import-characters) — do czego służy klucz importera
* [Reverie Labs](https://reverie.im/pl/docs/integrations/labs) — kafelki Otwartego API i importera
* [Bezpieczeństwo](https://reverie.im/pl/docs/account/security) — reszta ustawień dostępu do twojego konta