К содержимому

JetBrains AI Assistant API: настройка и подключение

JetBrains AI Assistant подключает собственные модели через раздел сторонних провайдеров с OpenAI-совместимым API. Настройка в интерфейсе, файла и переменных нет.

  • Тип: Редактор и IDE
  • Протокол: OpenAI Chat Completions
  • Статус: Работает
  • Версия при сверке: 2026.2
Сверено частично, 2026-10-02: в документации клиента есть пробел или источники расходятся. Не проверено вручную. Что проверить пробой, описано в разделе «Ловушки».

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Вызов инструментовЧастичноНужен включённый переключатель инструментов и модель с их поддержкой.
АвтодополнениеНетНужны модели с FIM, чат-модели не подходят.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

  1. Откройте Settings, Tools, AI Assistant, Providers and API keys и добавьте стороннего провайдера.
  2. Введите адрес https://relay-llm.ru/v1 и ключ. Включите переключатель вызова инструментов, если нужны MCP-инструменты.
  3. Нажмите Test Connection, затем выберите модель из каталога, например gpt-5.6-luna.

Поля стороннего провайдера

text
Base URL: https://relay-llm.ru/v1
API Key: YOUR_API_KEY
Tool calling (MCP): on

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Нажмите Test Connection в настройках, затем отправьте «ping» в чате AI Assistant. Запись появится в журнале кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Ловушки

  • Правило с /v1 для этого поля в справке не описано. Если Test Connection возвращает 404, уберите или добавьте /v1.
  • Окно контекста по умолчанию 64000 токенов. Для моделей с большим окном его можно поднять в настройках.
  • Автодополнению и предсказанию правок нужны модели с FIM и предсказанием правок. Обычные чат-модели их не дают.
  • Администратор JetBrains IDE Services может запретить сторонних провайдеров. Свой адрес для встроенного провайдера Anthropic в справке не описан.

Официальная документация: JetBrains AI Assistant API: настройка и подключение

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key