Przewodnik po platformie

Przypinanie grup

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

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ć.

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

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.

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.

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

Możesz też przypiąć grupę dla pojedynczego żądania bez zmiany klucza: wyślij nagłówek X-Group z dokładną nazwą grupy. Ma on pierwszeństwo nad zapisanym przypięciem klucza oraz nad automatycznym trasowaniem dla tego żądania. Skopiuj dowolną nazwę grupy z tabeli Cennika grup danego modelu.

bash

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

Nagłówek musi wskazywać grupę, z której klucz może korzystać, w przeciwnym razie żądanie zostanie odrzucone. Modele bez przypięcia zachowują trasowanie do najtańszego dostępnego dostawcy, gdy nagłówek nie jest wysyłany.

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.