Для AI-агентов: markdown этой страницы — /docs-content/ai/models/list.md индекс документации — /llms.txt
Список моделей
Ответ приходит в сыром OpenAI-формате.
Обёртки
{success, data}, которая используется в остальных эндпоинтах Вайбкод —/v1/deals,/v1/tasksи других, — здесь нет.Так сделано для совместимости с OpenAI SDK. Если у вас единый клиент с проверкой
if (!response.success), добавьте для AI Router исключение.
GET /v1/models
Возвращает каталог AI-моделей, доступных текущему API-ключу. Формат ответа полностью совместим с GET /v1/models из OpenAI API. Бесплатные модели Битрикс24 видны всем. Модели сторонних провайдеров видны только тем ключам, у которых есть доступ к учётным данным провайдера.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
capability (query) |
string | Выборка моделей по одной объявленной возможности вместо перебора полного списка на стороне клиента. Читается только у ключа со скоупом vibe:cowork. У остальных ключей игнорируется: ответ не меняется при любом значении, включая неизвестное. Набор допустимых значений закрыт и расширяется вместе с возможностями, которые платформа обслуживает для Коворка и Кода |
Примеры
curl — личный ключ
curl https://vibecode.bitrix24.tech/v1/models \
-H "X-Api-Key: YOUR_API_KEY"
curl — OAuth-приложение
curl https://vibecode.bitrix24.tech/v1/models \
-H "X-Api-Key: YOUR_APP_KEY" \
-H "Authorization: Bearer USER_SESSION_TOKEN"
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-приложение
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 и т. п. Для платформенных моделей, которые мы перепродаём, возвращается vibecode. |
data[].name |
string | Отображаемое название модели |
data[].context_length |
number | Максимальный размер контекста в токенах (вход + выход суммарно) |
data[].max_output_tokens |
number | Максимум токенов в ответе |
data[].pricing.prompt |
number | Стоимость 1М токенов входа |
data[].pricing.completion |
number | Стоимость 1М токенов ответа |
data[].pricing.perCall |
number | Плата за вызов в Вайбах. Присутствует только когда больше 0 |
data[].pricing.perMinute |
number | Плата за минуту аудио в Вайбах. Присутствует только когда больше 0 |
data[].pricing.unit |
string | Единица измерения цен: vibes — внутренняя валюта платформы |
data[].capabilities |
object | Возможности модели: streaming, vision, reasoning, audio, transcription, transcription_openai_only (модель распознавания не читает подсказки language, prompt, hotwords, temperature, vad_filter — см. «Расшифровать аудио»), tools, structured_outputs, embeddings, image_generation (модель генерации изображений — см. «Генерация изображений») |
data[].reasoning |
object | null | Декларация управления рассуждением. null — модель не декларирована. Иначе map — соответствие ступени платформы none, low, medium, high, max родному режиму модели. Две ступени с одним родным значением — объявленное схлопывание. default — ступень, которую платформа передаёт модели, когда параметр рассуждения не передан. budgetTokens — поддерживает ли модель бюджет токенов рассуждения |
Пример ответа
{
"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},
"reasoning": null
},
{
"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},
"reasoning": {"map": {"none": "none", "medium": "high", "max": "max"}, "default": "medium", "budgetTokens": false}
},
{
"id": "bitrix/bitrixgpt-5.5-agent",
"object": "model",
"created": 0,
"owned_by": "bitrix",
"name": "BitrixGPT 5.5 Agent",
"context_length": 262144,
"max_output_tokens": 65535,
"pricing": {"prompt": 68.4, "completion": 342, "unit": "vibes"},
"capabilities": {"streaming": true},
"reasoning": null
},
{
"id": "bitrix/bitrixgpt-5.6-agent",
"object": "model",
"created": 0,
"owned_by": "bitrix",
"name": "BitrixGPT 5.6 Agent 1M",
"context_length": 1048576,
"max_output_tokens": 384000,
"pricing": {"prompt": 100, "completion": 400, "unit": "vibes"},
"capabilities": {"streaming": true, "reasoning": true, "structured_outputs": true},
"reasoning": {"map": {"none": "none", "low": "low", "medium": "low", "high": "high", "max": "max"}, "default": "medium", "budgetTokens": false}
}
]
}
Пример ответа при ошибке
403 scope_missing — у API-ключа нет скоупа vibe:ai:
{
"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 |
| 401 | INVALID_API_KEY |
Ключ не опознан: такой строки на платформе нет |
| 429 | rate_limit_exceeded |
Превышен лимит запросов к AI-эндпоинтам. Время до сброса — в заголовке Retry-After |
Полный список общих ошибок API — Ошибки.
Известные особенности
Видимость зависит от настроенных учётных данных. В каталоге показаны только те модели, для которых текущий API-ключ имеет доступ к учётным данным провайдера — общим для всей платформы, общим в портале или вашим личным BYOK. Модели Битрикс24 (bitrix/*) доступны всем без подключения BYOK. Если нужной модели в списке нет — подключите свой ключ.
Модели в статусе DEPRECATED остаются в списке. Они помечены как устаревшие, но запросы к ним ещё работают — будут возвращены заголовки Deprecation и Sunset. Модели в статусе DISABLED из списка скрыты, но при явном указании в model будут прозрачно перенаправлены на модель-преемник.
Цены — в Вайбах за 1 миллион токенов. Поле pricing.unit: "vibes" явно маркирует валюту, чтобы внешний клиент мог программно проверить единицу измерения. Вайбы — внутренняя валюта платформы, баланс пополняется через личный кабинет.
Не все модели тарифицируются по токенам. У модели распознавания речи prompt и completion равны 0, а оплата идёт по полям perMinute за минуту аудио и perCall за вызов. Нулевые prompt и completion сами по себе не означают, что вызов бесплатный — проверяйте все четыре поля pricing.