Модели

Поле model принимает точное имя модели. Полный список с ценами и поддержкой кэша — на странице каталога.

• В идентификаторах используется vendor/model (в стиле OpenRouter), например anthropic/claude-opus-5; claude-opus-5 принимается как входной псевдоним с идентичной тарификацией.
• model:alias закрепляет канал, например openai/gpt-5.6-sol:yellow. GET /v1/models выводит по одному ID на модель; ?variants=1 возвращает полный список.

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

GET /api/catalog и GET /v1/pricing публикуют этот диапазон по модели (pricing) и по каналу (channels[]), считывая его из той же лестницы, по которой GET /api/model-ladder?model=<model> отдаёт свои предложения.

"pricing": {
  "basis": "fill",
  "unit": "USD per 1M tokens",
  "priceFrom":    { "input": 0.465, "output": 2.325 },
  "priceTypical": { "input": 0.5,   "output": 2.5 },
  "priceTo":      { "input": 1.5,   "output": 7.5 },
  "minChargePerRequest": 0.0000125,
  "ladder": "/api/model-ladder?model=claude-opus-5.5",
  "ladderUpdatedAt": "2026-09-25T08:45:01.522Z",
  "ladderStale": false
},
"channels": [
  { "address": "claude-opus-5.5:claude-code", "isDefault": true,
    "inputUsd": 0.465, "outputUsd": 2.325,
    "basis": "fill", "pool": "cc/claude-opus-5-5",
    "priceFrom": { "input": 0.465, "output": 2.325 },
    "priceTypical": { "input": 0.5, "output": 2.5 },
    "priceTo": { "input": 1.5, "output": 7.5 },
    "maxPriceCeiling": { "input": 0.6, "output": 3 },
    "minChargePerRequest": 0.0000125 }
]

У большинства моделей есть несколько публичных вариантов. Вариант по умолчанию выбирается автоматически (приоритет определяется настройками вашего аккаунта или ключа). Чтобы закрепить конкретный вариант для запроса, добавьте его псевдоним через двоеточие к имени модели:

"model": "gpt-6.1-sol"           // default variant (auto)
"model": "gpt-6.1-sol:yellow"    // explicit public variant
"model": "claude-opus-5.5"     // use an id from the catalog

Пример запроса с явным вариантом:

curl https://getvibeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4.8:yellow",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
# :yellow — pin a public variant for this request

Используйте только псевдонимы из каталога. Доступные суффиксы:

Полный список доступных идентификаторов моделей можно получить программно:

curl https://getvibeapi.com/v1/models \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

Помимо id/object/created/owned_by, каждая запись содержит type (chat, embedding, rerank, image, video, audio, music, 3d), architecture.input_modalities / output_modalities и endpoints — куда отправлять запрос для этой модели.

• Список по умолчанию содержит только чат-, embedding- и rerank-модели, поэтому средство выбора моделей в IDE никогда не предложит модель, не умеющую работать в чате.
• Медиамодели (изображение, видео, аудио, музыка, 3D) перечисляются по запросу: ?type=image (или список: ?type=image,video), ?output_modalities=image; ?modality= и ?category= — синонимы type.
• Всё сразу: ?all=true, ?type=all или GET /v1/models/all. Медиа перечисляется вместе со своими вариантами (model:alias) — именно тот id, который нужно отправить.
• GET /v1/models/{id} возвращает одну модель; неизвестный id — это 404 с code: "model_not_found".

curl "https://getvibeapi.com/v1/models?type=image,video" \
  -H "Authorization: Bearer $GETVIBE_API_KEY"

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

• /rss.xml (псевдоним /feed.xml) — это RSS 2.0; /feed.json — JSON Feed 1.1 с блоком _meta на уровне ленты и блоком _catalog для каждого события.
• Страницы: по 50 событий, ?limit= — до 100, сначала самые новые. Следующая страница (с более старыми событиями) указана в next_url в JSON Feed и в <atom:link rel="next"> в RSS (RFC 5005, также с rel="first" и rel="previous"). Ссылки содержат курсор, поэтому модель, опубликованная во время просмотра страниц, не сместит уже прочитанное событие. Используйте ссылки в том виде, в котором они возвращаются.
• Фильтры: ?kind=text|image|video|audio|music|3d|news и ?since=YYYY-MM-DD — только события начиная с указанного дня по UTC включительно. Фильтры работают вместе с пагинацией и сохраняются в ссылках.
• Событие model_added содержит заголовок, дату появления модели в каталоге, ссылку на страницу модели, описание, а в _catalog: публичные идентификаторы для передачи в качестве model (без вариантов написания маршрутов :alias и без названий поставщиков), эндпоинты, входные и выходные модальности, контекстное окно и максимальный объём вывода, возможности (инструменты, JSON / структурированный вывод, обработка изображений, рассуждение и его уровни, кеширование), публичную начальную цену в USD с единицей тарификации, для медиа — каждый параметр запроса с допустимыми значениями, готовый запрос (curl и JSON) и ссылку на документацию. Событие news — это публикация о нововведениях.
• guid события никогда не меняется. Лента не содержит сохранённых результатов генерации — только пример запроса.
• Опрашивайте ленту не чаще одного раза в несколько минут: у каждой страницы есть собственные ETag и Last-Modified; отправляйте If-None-Match / If-Modified-Since, и, если страница не изменилась, в ответ вы получите 304 без тела. Чтобы получать только новое, сохраняйте дату последнего обработанного события и запрашивайте ?since= с этой датой.

curl -sS "https://getvibeapi.com/feed.json?since=2026-10-01&limit=100"
curl -sS -i https://getvibeapi.com/feed.json -H 'If-None-Match: "<ETag from the previous response>"'   # -> 304