Szukaj w dokumentacji...

Zacznij wpisywać, aby przeszukać dokumentację

Przewodnik po platformie

Przypinanie grup

Zablokuj model na konkretnych grupach dostawców i ich stawkach zamiast automatycznego trasowania do najtańszego.

Trasowanie auto a przypinanie

Każdy model obsługuje jedna lub więcej grup dostawców, każda z własną ceną. Domyślnie klucz używa auto: każde żądanie trafia do najtańszej aktualnie działającej grupy.

Przypinanie nadpisuje to per model: wybierasz dokładnie, których grup może używać, a rozliczenia są zablokowane na ich stawkach. Przydatne, gdy potrzebujesz jakości lub regionu konkretnego dostawcy albo stawki, która nie może się zmieniać.

Podgląd cen grup

Strona szczegółów każdego modelu wymienia każdą grupę z ceną wejścia i wyjścia w sekcji Group Pricing; znaczek rabatu na liście modeli zawsze odzwierciedla najtańszą grupę.

Tabela cen grup na stronie szczegółów modelu

Przypinanie grup do klucza

Otwórz Klucze API, utwórz lub edytuj klucz i otwórz selektor grup. Wyszukaj model, kliknij go i zaznacz jedną lub więcej grup dostawców, posortowanych od najtańszej z mnożnikiem stawki. Modele, których nie ruszysz, zostają na auto.

Selektor grup dostawców per model w edytorze klucza

Przypięte modele wypływają na górę ze znaczkiem liczby grup, do których są przypięte; Wyczyść wszystko przywraca klucz do pełnego auto. Lista kluczy pokazuje przypięte klucze jako auto +N.

Jak trasują przypięte żądania

Przypięty model trasuje wyłącznie w obrębie przypiętych grup: najpierw próbowana jest najtańsza, z automatycznym przełączeniem na następną przy błędach lub awarii. Rozliczana jest stawka grupy, która faktycznie obsłużyła żądanie.

Jawny nagłówek X-Group w żądaniu nadal wygrywa z przypięciem, a nieprzypięte modele zachowują trasowanie do najtańszego dostępnego.

Połącz przypięcie z obserwacją, by wiedzieć, kiedy grupy zmieniają cenę lub padają, zobacz Powiadomienia

Gdy przypięte grupy padną

Jeśli wszystkie przypięte grupy modelu padły, a inni dostawcy wciąż go obsługują, żądania kończą się celowanym błędem zamiast ogólnego komunikatu:

json
{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

Poszerz lub usuń przypięcie na kluczu albo spróbuj później. Sam model nadal działa.