Закрепление групп

Каждую модель обслуживает одна или несколько групп провайдеров, у каждой своя цена. По умолчанию ключ использует auto: каждый запрос идёт в самую дешёвую живую группу.

Закрепление переопределяет это для каждой модели. Вы выбираете, какие группы она может использовать, и оплата фиксируется по их тарифам.

Страница каждой модели перечисляет все группы с ценой ввода и вывода в разделе Group Pricing. Значок скидки в списке моделей отражает самую дешёвую группу.

Откройте API-ключи, создайте или отредактируйте ключ и откройте выбор групп. Найдите модель, нажмите на неё и отметьте одну или несколько групп, отсортированных от самой дешёвой. Незатронутые модели остаются на auto.

Закреплённые модели поднимаются вверх со значком, показывающим число их групп. Clear all возвращает ключ в режим auto. В списке ключей закреплённые ключи отображаются как auto +N.

Закреплённая модель маршрутизируется только внутри своих групп, начиная с самой дешёвой, с переключением на резерв при ошибках. Ставка списания задаётся той группой, которая обслужила запрос.

Сочетайте закрепление с отслеживанием, чтобы узнавать, когда группы меняют цену или падают, смотрите Уведомления

Чтобы закрепить один запрос, не меняя ключ, отправьте заголовок X-Group с точным именем группы. Он переопределяет закрепление ключа и маршрутизацию auto. Имена копируйте из Group Pricing.

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" }]
  }'

Заголовок должен называть группу, доступную ключу, иначе запрос будет отклонён. Незакреплённые модели остаются на маршрутизации по минимальной цене.

Если все закреплённые группы недоступны, а другие провайдеры всё ещё обслуживают модель, запросы завершаются конкретной ошибкой, а не общим сообщением о занятости:

{
  "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"
  }
}

Расширьте или снимите закрепление либо повторите попытку позже. Сама модель работает.