Для AI-агентов: markdown этой страницы — /docs-content/ai/models/get.md индекс документации — /llms.txt

Получить модель

Ответ приходит в сыром OpenAI-формате.

Обёртки {success, data}, которая используется в остальных эндпоинтах Вайбкод — /v1/deals, /v1/tasks и других, — здесь нет.

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

GET /v1/models/:modelId

Возвращает детали одной модели по modelId. Используется, когда нужно проверить характеристики модели (контекст, цену, возможности) перед запросом к /v1/chat/completions. Формат ответа совместим с GET /v1/models/:id из OpenAI API.

Параметры

Параметр Тип Обяз. Описание
ПараметрmodelId (path) Типstring Обяз.да ОписаниеID модели из GET /v1/models. Может содержать слэши: openai/gpt-4o, bitrix/bitrixgpt-5.5, bitrix/google/gemma-4-26B-A4B-it. Полный путь после /v1/models/ рассматривается как modelId

Примеры

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

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

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

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

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

javascript 
const modelId = 'bitrix/bitrixgpt-5.5'
const res = await fetch(`https://vibecode.bitrix24.tech/v1/models/${modelId}`, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const model = await res.json()
console.log(`${model.name}: контекст ${model.context_length}, цена ${model.pricing.prompt}/${model.pricing.completion} Вайбов за 1M токенов`)

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

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

const model = await res.json()
console.log('Поддержка vision:', model.capabilities.vision === true)

Поля ответа

Поле Тип Описание
Полеid Типstring ОписаниеID модели
Полеobject Типstring ОписаниеВсегда model
Полеcreated Типnumber ОписаниеUnix-timestamp регистрации в каталоге Вайбкод (0 для платформенных)
Полеowned_by Типstring ОписаниеСистемное имя провайдера: bitrix, openai, anthropic, openrouter, google и т. п. Для платформенных моделей, которые мы перепродаём, возвращается vibecode.
Полеname Типstring ОписаниеОтображаемое название модели
Полеcontext_length Типnumber ОписаниеМаксимальный размер контекста в токенах
Полеmax_output_tokens Типnumber ОписаниеМаксимум токенов в ответе
Полеpricing.prompt Типnumber ОписаниеСтоимость 1М токенов входа
Полеpricing.cachedPrompt Типnumber или null ОписаниеСтоимость 1М кешированных токенов входа (usage.prompt_tokens_details.cached_tokens). Поле есть всегда. null — отдельной цены нет, кешированная часть входа тарифицируется по prompt. Запись в кеш отдельно не тарифицируется
Полеpricing.completion Типnumber ОписаниеСтоимость 1М токенов ответа
Полеpricing.perCall Типnumber ОписаниеПлата за вызов в Вайбах. Присутствует только когда больше 0
Полеpricing.perMinute Типnumber ОписаниеПлата за минуту аудио в Вайбах. Присутствует только когда больше 0
Полеpricing.unit Типstring ОписаниеЕдиница измерения цен: vibes
Поле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 (модель генерации изображений — см. «Генерация изображений»)
Полеreasoning Типobject | null ОписаниеДекларация управления рассуждением. null — модель не декларирована. Иначе map — соответствие ступени платформы none, low, medium, high, max родному режиму модели. Две ступени с одним родным значением — объявленное схлопывание. default — ступень, которую платформа передаёт модели, когда параметр рассуждения не передан. budgetTokens — поддерживает ли модель бюджет токенов рассуждения
Полеreplaced_by Типstring ОписаниеИдентификатор модели-преемника. Присутствует только когда запрошенный id снят с публикации и его вызовы обслуживает другая модель. В этом случае pricing показывает цену преемника

Так выглядит ответ для снятой с публикации модели:

JSON 
"pricing": { "prompt": 68.4, "cachedPrompt": null, "completion": 342, "unit": "vibes" },
"replaced_by": "bitrix/bitrixgpt-5.5-agent"

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

JSON 
{
  "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
}

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

404 ai_model_not_found — модель не найдена или у ключа нет к ней доступа:

JSON 
{
  "error": {
    "message": "Model \"openai/gpt-4o\" not found or disabled.",
    "type": "invalid_request_error",
    "code": "ai_model_not_found"
  }
}

Ошибки

HTTP Код Описание
HTTP404 Кодai_model_not_found ОписаниеМодель с таким modelId не существует, отключена или у ключа нет доступа
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 — Ошибки.

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

modelId со слэшами. Эндпоинт принимает любое количество сегментов после /v1/models/. Например, GET /v1/models/bitrix/google/gemma-4-26B-A4B-it будет прочитан как modelId = "bitrix/google/gemma-4-26B-A4B-it". URL-кодировать слэши не нужно.

Видимость как у списка. Если модель не отображается в GET /v1/models — запрос на GET /v1/models/:modelId вернёт 404, даже если модель формально есть в каталоге платформы. Это значит, что у вашего ключа нет к ней доступа. Подключите учётные данные через BYOK.

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