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

Посмотреть доступные модели

GET /v1/ai/credentials/:id/available-models

Живой список провайдера через выбранный ключ. Модели не сохраняются. connected и rowId относятся только к этому ключу. Если список недоступен, ответ остаётся 200: models: [] и unavailable с очищенным сообщением. Модель можно подключить по имени.

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

Параметры

Параметр Тип Обяз. Описание
Параметрid (path) Типstring Обяз.да ОписаниеID ключа из списка

Примеры

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

Terminal 
curl https://vibecode.bitrix24.tech/v1/ai/credentials/cred_xyz/available-models \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl https://vibecode.bitrix24.tech/v1/ai/credentials/cred_xyz/available-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/ai/credentials/cred_xyz/available-models', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const { data } = await res.json()
console.log(data)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/ai/credentials/cred_xyz/available-models', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    Authorization: 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()
console.log(data)

Поля ответа

Поле Тип Описание
Полеdata.models[].id Типstring ОписаниеID у провайдера
Полеdata.models[].modelId Типstring ОписаниеПубличный ID <slug>/<id>
Полеdata.models[].name Типstring ОписаниеНазвание
Полеdata.models[].contextLength Типinteger ОписаниеКонтекст в токенах. По умолчанию 4096
Полеdata.models[].maxOutputTokens Типinteger / null ОписаниеМаксимальный ответ в токенах
Полеdata.models[].capabilities Типobject / null ОписаниеВозможности модели
Полеdata.models[].connected Типboolean ОписаниеМодель уже подключена к ключу
Полеdata.models[].rowId Типstring / null ОписаниеID строки модели ключа, тот же id, что в списке моделей ключа, либо null
Полеdata.unavailable Типobject ОписаниеНеобязательный объект: code равен provider_list_models_unavailable, message очищено от ключа и адреса прокси

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

JSON 
{"success":true,"data":{"models":[{"id":"gpt-4o-mini","modelId":"openai/gpt-4o-mini","name":"GPT-4o mini","contextLength":128000,"maxOutputTokens":16384,"capabilities":{"tools":true},"connected":false,"rowId":null}]}}

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

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

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

Ошибки

HTTP Код Описание
HTTP400 Кодno_key ОписаниеКлюч не содержит значения API-ключа
HTTP400 Кодbase_url_redirect ОписаниеПровайдер вернул запрещённое перенаправление
HTTP403 Кодscope_missing Описаниеvibe:ai
HTTP404 Кодnot_found ОписаниеКлюч недоступен
HTTP429 Кодmodel_discovery_busy ОписаниеДругой запрос списка моделей уже выполняется
HTTP429 Кодmodel_discovery_rate_limit ОписаниеПревышена частота запросов списка моделей
HTTP500 Кодdecryption_error ОписаниеНе удалось расшифровать ключ

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

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

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

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