Klucze API

Twórz, ograniczaj i unieważniaj klucze używane przez aplikacje.

Utwórz osobny klucz dla każdej aplikacji lub środowiska programistycznego. Dzięki temu każdy z nich możesz niezależnie nazwać, ograniczyć i unieważnić. Klucz kupującego uwierzytelnia żądania do unused.market; dane dostawcy podawane w Sell służą do czegoś innego.

Utwórz i zapisz klucz

  1. Otwórz API Keys → Create new key.
  2. Wpisz rozpoznawalną nazwę i wybierz Create key.
  3. Wybierz Copy i zapisz pełną wartość w konfiguracji sekretów aplikacji.

Pełny klucz pojawia się tylko raz. Później panel zwraca zamaskowaną wartość. Jeśli go zgubisz, utwórz nowy i unieważnij stary.

Na każdej trasie bramy podaj Authorization: Bearer <key> albo x-api-key: <key>. Użyj pełnej wartości klucza, a nie jego nazwy ani zamaskowanego tekstu.

Ustaw miesięczny limit i dozwolone modele

Otwórz ustawienia klucza, zmień poniższe opcje i wybierz Save settings.

Ustawienia klucza z opcjami Monthly limit i Selected models
OpcjaDziałanie
No limit / Monthly limitUsuwa limit wydatków klucza albo ustawia dodatni limit w USD. Konto nadal musi mieć kredyty.
All models / Selected modelsDopuszcza każdy model spełniający pozostałe warunki albo ogranicza klucz do wybranych modeli.
Currently unavailable modelsPokazuje zapisane wybory również wtedy, gdy modele są niedostępne. Usuń wybór ręcznie, jeśli już go nie potrzebujesz.

Budżet miesięczny obejmuje miesiąc kalendarzowy w UTC. Żądanie musi zmieścić się w pozostałym budżecie z uwzględnieniem aktywnych blokad środków. Przekroczenie limitu daje 402, a użycie modelu spoza dozwolonego zestawu — 403.

Last 30 days oznacza wydatki z ostatnich 30 dni. Panel ustawień używa obecnie tej wartości do wyświetlania szacunku „left under the limit”, choć limit jest egzekwowany dla miesiąca kalendarzowego w UTC. Na przełomie miesięcy te kwoty mogą się różnić.

Wybór modeli dla klucza i listy na stronie Routing obowiązują równocześnie. Zezwolenie na model w ustawieniach klucza nie omija listy blokowanych ani dozwolonych modeli w routingu.

Sprawdź aktywność klucza

Last 30 days to koszt przypisany do klucza w ostatnich 30 dniach. Share of usage oznacza udział w wydatkach widocznych kluczy, a nie w liczbie tokenów. Used wskazuje ostatnie zarejestrowane użycie. Nowy klucz pokazuje Never used, dopóki użycie nie zostanie zapisane.

Unieważnij klucz

Wybierz Revoke i przejdź przez przyciski potwierdzenia w tym wierszu. Klucz znika z aktywnej listy i nie uwierzytelni nowych żądań. Zanim unieważnisz klucz używany przez działające aplikacje, skonfiguruj w nich jego zamiennik.

Utworzenie klucza, zmiany ustawień i unieważnienie znajdziesz w Analytics → Audit Log, w kategorii Keys.

Na tej stronie