Список моделей — AI Router — Битрикс24 VibeCode

#Список моделей

Формат ответа: raw OpenAI

Этот endpoint возвращает «голый» OpenAI-shape — БЕЗ envelope {success, data}, который используется в остальных endpoint'ах Вайбкод (/v1/deals, /v1/tasks и т.д.).

Это сделано для совместимости с OpenAI SDK. Если у вас единый клиент с проверкой if (!response.success) — сделайте исключение для AI Router.

GET /v1/models

Возвращает каталог AI-моделей, доступных текущему API-ключу. Формат ответа полностью совместим с GET /v1/models из OpenAI API. Бесплатные модели Битрикс24 видны всем; модели сторонних провайдеров — только тем ключам, которые имеют доступ к учётным данным провайдера (PLATFORM, PORTAL или USER credential).

#Параметры

Параметров запроса нет.

#Примеры

#curl — личный ключ

Terminal

curl https://vibecode.bitrix24.tech/v1/models \
  -H "X-Api-Key: YOUR_API_KEY"

#curl — OAuth-приложение

Terminal

curl https://vibecode.bitrix24.tech/v1/models \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

#JavaScript — личный ключ

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/models', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { data } = await res.json()
data.forEach((m) => {
  console.log(`${m.id} — ${m.name}, контекст ${m.context_length}, цена ${m.pricing.prompt}/${m.pricing.completion} Вайбов за 1М токенов`)
})

#JavaScript — OAuth-приложение

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/models', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { data } = await res.json()
console.log('Доступно моделей:', data.length)

#Поля ответа

Поле	Тип	Описание
`object`	string	Всегда `list`
`data`	array	Массив моделей
`data[].id`	string	ID модели — используйте в `model` запроса к `/v1/chat/completions`
`data[].object`	string	Всегда `model`
`data[].created`	number	Unix-timestamp регистрации модели в каталоге Вайбкод (`0` для платформенных)
`data[].owned_by`	string	Системное имя провайдера: `bitrix`, `openai`, `anthropic`, `openrouter`, `google` и т. п.
`data[].name`	string	Отображаемое название модели
`data[].context_length`	number	Максимальный размер контекста в токенах (вход + выход суммарно)
`data[].max_output_tokens`	number	Максимум токенов в ответе
`data[].pricing.prompt`	number	Стоимость 1М токенов входа
`data[].pricing.completion`	number	Стоимость 1М токенов ответа
`data[].pricing.unit`	string	Единица измерения: `vibes` (внутренняя валюта платформы). Бесплатные модели имеют `prompt: 0, completion: 0`
`data[].capabilities`	object	Возможности модели: `streaming`, `vision`, `reasoning`, `audio`, `transcription`, `function_calling`, `json_mode`

#Пример ответа

JSON

{
  "object": "list",
  "data": [
    {
      "id": "bitrix/bitrixgpt-5.5",
      "object": "model",
      "created": 0,
      "owned_by": "bitrix",
      "name": "BitrixGPT 5.5 (бесплатная)",
      "context_length": 262144,
      "max_output_tokens": 65536,
      "pricing": {"prompt": 0, "completion": 0, "unit": "vibes"},
      "capabilities": {"streaming": true, "vision": true, "structured_outputs": true}
    },
    {
      "id": "bitrix/bitrixgpt-5.5-thinking",
      "object": "model",
      "created": 0,
      "owned_by": "bitrix",
      "name": "BitrixGPT 5.5 Thinking (бесплатная)",
      "context_length": 262144,
      "max_output_tokens": 65536,
      "pricing": {"prompt": 0, "completion": 0, "unit": "vibes"},
      "capabilities": {"streaming": true, "vision": true, "reasoning": true, "structured_outputs": true}
    },
    {
      "id": "bitrix/moonshotai/Kimi-K2.6",
      "object": "model",
      "created": 0,
      "owned_by": "bitrix",
      "name": "Kimi K2.6 (Bitrix)",
      "context_length": 262144,
      "max_output_tokens": 65535,
      "pricing": {"prompt": 0, "completion": 0, "unit": "vibes"},
      "capabilities": {"streaming": true}
    }
  ]
}

#Пример ответа при ошибке

403 scope_missing — у API-ключа нет скоупа vibe:ai:

JSON

{
  "error": {
    "message": "API key does not have the vibe:ai scope required for AI endpoints. Add vibe:ai scope to your API key in portal settings.",
    "type": "invalid_request_error",
    "code": "scope_missing"
  }
}

#Ошибки

HTTP	Код	Описание
403	`scope_missing`	API-ключу не хватает скоупа `vibe:ai`
401	`MISSING_API_KEY`	Не передан заголовок `X-Api-Key`

Полный список общих ошибок API — Ошибки.

#Известные особенности

Видимость зависит от настроенных учётных данных. В каталоге показаны только те модели, для которых текущий API-ключ имеет доступ к credential провайдера: PLATFORM (общая для всей платформы), PORTAL (общая в портале) или USER (ваш личный BYOK). Модели Битрикс24 (bitrix/*) доступны всем без подключения BYOK. Если нужной модели в списке нет — подключите свой ключ.

Модели в статусе DEPRECATED остаются в списке. Они помечены как устаревшие, но запросы к ним ещё работают — будут возвращены заголовки Deprecation и Sunset. Модели в статусе DISABLED из списка скрыты, но при явном указании в model будут прозрачно перенаправлены на модель-преемник.

Цены — в Вайбах за 1 миллион токенов. Поле pricing.unit: "vibes" явно маркирует валюту, чтобы внешний клиент мог программно проверить единицу измерения. Вайбы — внутренняя валюта платформы; пополнение баланса доступно через личный кабинет.

#Смотрите также

Получить модель — детали конкретной модели по id
Создать чат-комплишен — использование выбранной модели
Свои ключи (BYOK) — подключение моделей сторонних провайдеров