Для 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.cachedPrompt |
Типnumber или null | ОписаниеСтоимость 1М кешированных токенов входа (usage.prompt_tokens_details.cached_tokens). Поле есть всегда. null — отдельной цены нет, кешированная часть входа тарифицируется по prompt. Запись в кеш отдельно не тарифицируется |
Поле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 — см. «Расшифровать аудио»), diarization (метки говорящих для двух сторон разговора в verbose_json — см. «Расшифровать аудио»), 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, "cachedPrompt": null, "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, "cachedPrompt": null, "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, "cachedPrompt": null, "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, "cachedPrompt": null, "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}
},
{
"id": "bitrix/bitrixgpt-6.0-agent",
"object": "model",
"created": 0,
"owned_by": "bitrix",
"name": "BitrixGPT 6.0 Agent 1M",
"context_length": 1048576,
"max_output_tokens": 131072,
"pricing": {"prompt": 50, "cachedPrompt": null, "completion": 200, "unit": "vibes"},
"capabilities": {"reasoning": true},
"reasoning": {"map": {"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 | Код | Описание |
|---|---|---|
| HTTP403 | Кодscope_missing |
ОписаниеAPI-ключу не хватает скоупа vibe:ai |
| HTTP401 | КодMISSING_API_KEY |
ОписаниеНе передан заголовок X-Api-Key |
| HTTP401 | КодINVALID_API_KEY |
ОписаниеКлюч не опознан: такой строки на платформе нет |
| HTTP429 | Код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.