Маршрутизация и лимиты ключа

Для запроса по умолчанию (когда вы указали просто имя модели, без суффикса :N) шлюз сам выбирает, как его обслужить. Поведение настраивается — на уровне аккаунта или отдельного ключа. Имена внутренних поставщиков не раскрываются: вы управляете только стратегией.

Стратегия маршрутизации

Параметр	Тип	Описание
`priority (по умолчанию)`	strategy	Обычный маршрут по умолчанию.
`price`	strategy	Выбирать вариант с наименьшей ценой среди доступных для модели.
`latency`	strategy	Выбирать самый быстрый по недавним замерам вариант.
`cacheOnly`	boolean	Только кэширующие варианты — выгодно при повторяющемся префиксе промпта.

Стратегия применяется только к запросам по умолчанию. Если вы явно указали вариант суффиксом :2 — он всегда уважается и маршрутизация его не переопределяет. Настраивается в личном кабинете для аккаунта или для конкретного ключа (ключ имеет приоритет над аккаунтом).

Выбор варианта вручную

Не хотите автоматику — выберите вариант сами суффиксом :N в поле model:

curl https://plusvibeapi.ru/v1/chat/completions \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8:2",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'
# :2 — альтернативный (обычно более дешёвый) вариант той же модели

Лимиты ключа

Для каждого API-ключа в кабинете можно задать:

Параметр	Тип	Описание
`allowedModels`	список моделей	Белый список моделей, которые разрешено вызывать этим ключом. Пусто — разрешены все. Запрос модели вне списка получает 403.
`routingStrategy / cacheOnly`	переопределение	Своя стратегия и фильтр кэша для ключа — переопределяют настройки аккаунта.
`limitRub`	лимит трат	Лимит расходов на ключ.
`allowedIps`	белый список IP	Ограничение по IP (см. раздел «Аутентификация»).

Это удобно для раздачи ключей командам и интеграциям: один ключ — только дешёвые модели, другой — с лимитом трат, третий — со своей стратегией. Всё настраивается в личном кабинете.

← Баланс и история Кэширование промпта →