Прозрачная маршрутизация и разбивка рейсов

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

"model": "claude-opus-4.8"          // auto — key strategy
"model": "claude-opus-4.8:yellow"   // pin — :yellow only, no switching to other channels
"model": "claude-opus-4.8:2"        // pin — catalog variant #2 (legacy :N syntax)

Каждая модель обслуживается несколькими каналами по разным ценам — своего рода лестницей. Эти два параметра тела запроса указывают, какие ступени этой лестницы могут вас обслуживать. Оба выражаются в USD за 1M токенов — та же единица измерения и те же числа, что печатает страница Models. Они сравниваются с нашей ценой — тем, что списывается с вас, — и никогда с оптовым числом, которое вы не видите.

{
  "model": "deepseek-v4-flash-0731",
  "messages": [{"role": "user", "content": "hi"}],
  "max_price": 0.02,
  "min_price": {"input": 0.001}
}

Обе составляющие должны укладываться в лимит — и вход, и выход, а не их среднее. Канал, дешёвый на входе и дорогой на выходе, не удовлетворяет ограничению по одному числу.

Постоянный потолок, задаётся один раз в кабинете

Потолок не обязательно указывать в каждом вызове. Дашборд хранит один потолок на API-ключ и на модель, плюс значение по умолчанию, которое покрывает все модели, для которых вы не задали его явно, и API читает его при каждом запросе. Запрос, содержащий max_price, использует это значение только для данного вызова; запрос без него использует ваш сохранённый потолок. Приоритет, от самого конкретного:

Где посмотреть цены, которые вы ограничиваете

GET /api/catalog публикует массив channels для каждой модели: по одной записи на каждый канал, на который может попасть запрос, от самого дешёвого, с адресом, по которому его можно закрепить, его ценой inputUsd / outputUsd за 1M токенов и признаком того, является ли он каналом по умолчанию. Это те самые числа, с которыми сравниваются max_price и min_price, и те самые числа, по которым с вас списывают средства — один список, а не три.

curl -s https://getvibeapi.com/api/catalog   | jq '.[] | select(.apiModel=="z-ai/glm-5.3") | .channels'

За что вы платите

Вы платите за канал, который фактически обслужил запрос, плюс нашу фиксированную наценку — не за установленный вами потолок и никогда не больше него. Если вы ограничиваете цену, а запрос закрывается на более дешёвой ступени, вы платите по более дешёвой. Лестница на странице модели показывает диапазон, и значение «от» — это самая дешёвая существующая ступень: это реальная цена, которую с вас могут взять, а не обещание, что этот запрос попадёт именно на неё. Указывайте max_price, когда вам нужна гарантированная верхняя граница.

Когда ничего не подходит

Запрос отклонён: HTTP 422 с "type": "price_bound_no_lane", где указаны самая дешёвая и самая дорогая цены канала для этой модели и полный список channels, чтобы вы могли выбрать лимит по числам, а не угадывать его. lowest_passing_usd_per_million — это наименьший лимит, который прямо сейчас допускает канал: собственная пара одного канала, поэтому его отправка проходит (два плеча cheapest могут относиться к разным каналам). То же поле появляется, когда сама биржа отклонила ваш лимит: тогда это следующий ценовой уровень, на котором ещё есть предложение, и он никогда не ниже отправленного вами лимита. Когда лимитом были не вы — им был наш собственный потолок закупки для канала, а предложения под ним оказались заняты или исчерпаны — ответ вместо этого HTTP 503 "type": "no_seller_available" с Retry-After и без предложенной цены: повышение max_price не помогло бы, а повтор чуть позже мог бы. Самая дешёвая ступень часто содержит единственное предложение, которое занято, поэтому для надёжного исполнения устанавливайте лимит на уровне priceTypical модели или выше, где сосредоточена основная часть предложения. Мы никогда не обслуживаем молча более дорогой канал и никогда не подменяем модель другой. Некорректное значение — строка, ноль, отрицательное число, неизвестное поле — это 400 invalid_request_error, и оно никогда не игнорируется молча.

{
  "error": {
    "message": "No channel of model "deepseek-v4-flash-0731" is priced within your max_price $0.0001 in / $0.0001 out...",
    "type": "price_bound_no_lane",
    "code": 422,
    "param": "max_price",
    "cheapest_usd_per_million": {"input": 0.0065, "output": 0.013},
    "dearest_usd_per_million": {"input": 0.0528, "output": 0.1584},
    "lowest_passing_usd_per_million": {"input": 0.0205, "output": 0.0613},
    "channels": [
      {"address": "deepseek/deepseek-v4-flash-0731:codebuddy-cn", "label": "codebuddy-cn", "inputUsd": 0.0205, "outputUsd": 0.0613, "isDefault": true},
      {"address": "deepseek/deepseek-v4-flash-0731:qwencloud", "label": "qwencloud", "inputUsd": 0.0378, "outputUsd": 0.1132, "isDefault": false}
    ]
  }
}

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

"model": "gpt-6.1-sol:codex"         // pin a subscription pool
"model": "claude-opus-5.5:claude-code"  // pin the Claude Code pool

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

Для запросов auto (модель без суффикса) для каждого API-ключа задаются следующие настройки (панель управления → API-ключи):

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

"model": "claude-opus-4.8"        // auto — key strategy
"model": "claude-opus-4.8:yellow"     // explicitly pin the :yellow channel
"model": "claude-opus-4.8:kiro-pool"  // explicitly pin the :kiro-pool channel

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

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

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

Повторные попытки с экспоненциальным backoff при 429 описаны в разделе Errors and limits.

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

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

curl -sD - https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
  -o /dev/null | grep -i getvibe

# x-getvibe-route: yellow
# x-getvibe-model: gpt-6.1-sol:yellow

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

В GET /v1/generations, GET /v1/usage и панели управления каждая запись содержит поля:

GetVibe не предоставляет «сырой» каскадный список вышестоящих провайдеров в теле запроса. Управление осуществляется через публичный :alias, стратегию ключа и автоматическое переключение при сбоях в рамках каталога моделей. Отдельного API «игнорировать провайдеров» или флагов маршрутизации ZDR нет.