Добавить модель вручную

POST /v1/ai/credentials/:id/models

Подключает модель к ключу любого провайдера. Передайте один modelId или пакет modelIds (от 1 до 100 строк). Для ключей всех провайдеров, кроме Custom-провайдера, метаданные берутся в порядке: тело запроса → живой список → умолчания. Если список недоступен, подключение по имени работает. Для одиночного запроса к Custom-провайдеру контракт сохраняется: любая строка длиной до 200 символов, непустая после удаления пробелов по краям, метаданные тела имеют приоритет.

Требуется скоуп vibe:ai. Публичный API работает только с вашим USER-ключом. Чужой, несуществующий или PORTAL-ключ возвращает 404 not_found.

Параметры

Поля запроса (body)

Примеры

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

curl -X POST https://vibecode.bitrix24.tech/v1/ai/credentials/cred_custom_xyz/models \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "abab6.5-chat",
    "name": "MiniMax abab6.5-chat",
    "contextLength": 32768,
    "maxOutputTokens": 8192
  }'

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

curl -X POST https://vibecode.bitrix24.tech/v1/ai/credentials/cred_custom_xyz/models \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "abab6.5-chat",
    "name": "MiniMax abab6.5-chat",
    "contextLength": 32768,
    "maxOutputTokens": 8192
  }'

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

const id = 'cred_custom_xyz'
const res = await fetch(`https://vibecode.bitrix24.tech/v1/ai/credentials/${id}/models`, {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    modelId: 'abab6.5-chat',
    name: 'MiniMax abab6.5-chat',
    contextLength: 32768,
    maxOutputTokens: 8192,
  }),
})

const { data } = await res.json()
console.log('Зарегистрирована модель с id:', data.id)

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

const id = 'cred_custom_xyz'
const res = await fetch(`https://vibecode.bitrix24.tech/v1/ai/credentials/${id}/models`, {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    modelId: 'abab6.5-chat',
    name: 'MiniMax abab6.5-chat',
    contextLength: 32768,
    maxOutputTokens: 8192,
  }),
})

const { data } = await res.json()
console.log('Зарегистрирована модель с id:', data.id)

Поля ответа

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

Одиночный запрос modelId, HTTP-статус 201 Created:

{
  "success": true,
  "data": {
    "id": "aimodel_xyz789",
    "modelId": "custom-openai-compat/abab6.5-chat",
    "name": "MiniMax abab6.5-chat",
    "contextLength": 32768
  }
}

Пакетный запрос { "modelIds": ["gpt-4o-mini", "gpt-4o"] }, HTTP-статус 200 OK. Модель gpt-4o уже была подключена к ключу:

{
  "success": true,
  "data": {
    "created": [
      { "modelId": "gpt-4o-mini", "rowId": "aimodel_xyz789" }
    ],
    "skipped": [
      { "modelId": "gpt-4o", "reason": "already_connected" }
    ]
  }
}

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

404 not_found — ключ не найден или принадлежит другому пользователю:

{
  "success": false,
  "error": {
    "code": "not_found",
    "message": "Credential not found"
  }
}

Ошибки

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

Лимит регистрации моделей: 30 запросов в минуту. Действующее значение — в заголовке x-ratelimit-limit.

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

Цена — нулевая. Модели ключа всегда регистрируются с нулевой ценой (inputPrice = 0, outputPrice = 0). Платформа такие записи не тарифицирует — вы платите провайдеру напрямую.

Пакетное подключение. Передайте { "modelIds": ["gpt-4o-mini", "gpt-4o"] } без modelId. Весь пакет проверяется до записи. ID для провайдеров, кроме Custom-провайдера, содержат только [A-Za-z0-9._:/@-], до 200 символов. Один снимок списка используется для всего пакета. Ответ 200: created содержит { modelId, rowId }, skipped — { modelId, reason: "already_connected" }. В пакетном ответе modelId — исходный ID провайдера. Повторы и одновременные запросы на ту же модель попадают в skipped.

На ключе не больше 1000 строк. Превышение возвращает 409 key_models_limit без частичной записи пакета. Одиночный повтор — 409 already_exists, успешный одиночный ответ остаётся 201. Новая строка наследует capabilities и reasoningControl одноимённой модели платформы. При отсутствии такой строки используются возможности из списка провайдера.

Пределы запроса списка моделей. Они общие для available-models, fetch-models и подключения: 20 секунд на все повторы и страницы, до 5 МиБ на ответ до разбора JSON, до 1000 моделей и 10 страниц. Повтор курсора останавливает обход. На один портал одновременно выполняется один такой запрос, частота — 10 в минуту. При неполном списке отсутствующие модели не переводятся в DEPRECATED.

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

• Посмотреть доступные модели
• Загрузить каталог моделей
• Список моделей ключа
• Удалить модель ключа
• Создать чат-комплишен