Прозрачная маршрутизация и flight breakdown

PlusVibe — прозрачный маршрутизатор: вы либо явно выбираете публичный вариант через суффикс :alias, либо оставляете имя модели без суффикса — тогда шлюз сам подбирает маршрут по стратегии аккаунта/ключа и при сбоях переключается на другой доступный вариант. В ответах и истории используются только публичные идентификаторы маршрутов.

"model": "claude-opus-4.8"          // auto — стратегия аккаунта/ключа
"model": "claude-opus-4.8:sub"      // pin — только :sub, без переключения на :nexus
"model": "claude-opus-4.8:2"        // pin — вариант №2 из каталога (устаревший :N синтаксис)

Суффикс после двоеточия — это публичный идентификатор маршрута, а не имя upstream. Полный перечень для конкретной модели — в каталоге (Модели, колонка «В API»). Основные псевдонимы:

Для auto-запросов (bare model) в личном кабинете задаются:

Добавьте псевдоним провайдера через двоеточие — он уважается независимо от стратегии маршрутизации. Полный список псевдонимов и примеры — в разделе Модели → Провайдеры.

"model": "claude-opus-4.8"        // auto — стратегия аккаунта/ключа
"model": "claude-opus-4.8:sub"    // явно зафиксировать провайдера :sub
"model": "claude-opus-4.8:nexus"  // явно зафиксировать провайдера :nexus

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

В кабинете: Модели → карточка модели → Маршрутизация → «Самый быстрый», для всех ключей или для одного. Запрос без суффикса идёт в канал с самым быстрым первым токеном по живым замерам за последние 15 минут. Каналы на паузе после сбоев пропускаются, пока есть здоровые; каналы дороже вашего лимита цены не выбираются никогда. Цена — цена канала, который ответил. На запросы с явным :alias режим не влияет.

Лимит в ₽ за 1 млн токенов сравнивается с ценой канала из каталога — той, что списывается. Должны пройти обе ноги, вход и выход. Запрос без суффикса идёт только в каналы не дороже лимита, в том числе при переключении после сбоя.

{
  "model": "deepseek-v4.1-flash",
  "messages": [{"role": "user", "content": "привет"}],
  "max_price": {"input": 2.5, "output": 10}
}

При bare model шлюз может переключиться на другой публичный вариант той же модели, если текущий вернул 429, 5xx или пустой 200 без контента. Ограничения:

• Запросы с изображениями/PDF не переключаются на другой провайдер (vision-совместимость).
• Failover не уходит на вариант существенно дороже (кроме strategy=price).
• Есть верхняя граница числа попыток на один клиентский запрос.
• При pin (:alias) межпровайдерный failover отключён — вы получаете ошибку выбранного маршрута.

Повтор с экспоненциальной задержкой при 429 описан в Ошибки и лимиты.

Для доверенных reveal/debug-клиентов после выполнения запроса (включая auto) доступны заголовки с тем, какой публичный вариант реально отработал. Обычным клиентам эти данные не возвращаются.

Заголовки ответа для доверенных reveal/debug-клиентов (chat / messages / responses)

curl -sD - https://plusvibeapi.ru/v1/chat/completions \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
  -o /dev/null | grep -i x-plusvibe

# x-plusvibe-route: sub5plus
# x-plusvibe-model: gpt-5.6-luna:sub5plus

История использования

В GET /v1/generations, GET /v1/usage и кабинете к каждой записи добавлены поля:

PlusVibe не предоставляет «сырой» waterfall с перечислением upstream-провайдеров в теле запроса. Управление — через публичные :alias, стратегию ключа и auto-failover внутри каталога модели. Нет отдельного API «ignore providers» или ZDR-флагов маршрутизации.