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

Каждую модель обслуживает одна или несколько групп провайдеров, у каждой своя цена. По умолчанию ключ использует 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"
  }
}

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