Klucze API
Tworzenie, zawężanie i zarządzanie kluczami do API.
Klucz API uwierzytelnia żądania do Otwartego 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
Naciśnij „Utwórz nowy klucz API”
Na pustej stronie przycisk mówi Utwórz swój pierwszy klucz API.
Nazwij go
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ć
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
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
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
| 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
| 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
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 →
Statystyki użycia
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
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
| 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
- Otwarte API — punkty końcowe, kształt żądania i błędy
- Import postaci — do czego służy klucz importera
- Reverie Labs — kafelki Otwartego API i importera
- Bezpieczeństwo — reszta ustawień dostępu do twojego konta