Назад

OpenAI ноды

OpenAI ноды

OpenAI ноды — подключения к внешним OpenAI-совместимым API (OpenAI, Anthropic, Azure OpenAI и другие). RouterAI маршрутизирует запросы к облачным моделям через эти ноды.

Основные возможности

  • Подключение внешних OpenAI-совместимых API
  • Автоматическая синхронизация списка доступных моделей при создании
  • Включение/отключение нод
  • Мониторинг статуса подключения
  • Настройка приоритета и веса для балансировки нагрузки
  • Настройка поддерживаемых API форматов (Responses API, Messages API)
  • Ручной список моделей для провайдеров без /v1/models
  • Включение/отключение отдельных моделей на ноде

Список нод

Колонка Описание
Название Имя ноды
URL Базовый адрес API
Статус Текущий статус ноды
Моделей Количество синхронизированных моделей
Последняя синхронизация Время последней синхронизации моделей

Статусы ноды

Статус Описание
idle Нода подключена, ожидает запросов
ready Нода готова к работе
error Ошибка подключения
offline Нода недоступна

Добавление ноды

  1. Нажмите Добавить ноду
  2. Заполните поля:

Основные настройки

Поле Тип Описание
Название Строка Произвольное имя для идентификации
Base URL URL Базовый адрес API включая версию (например, https://api.openai.com/v1). Пути /models, /chat/completions добавляются автоматически
API Key Строка Ключ доступа к API (Bearer token). Опционально
Нода включена Флаг Включить ноду сразу после создания

Настройки маршрутизации

Поле Тип Описание
Приоритет Число (0–100) Чем выше значение — тем приоритетнее нода. Ноды с наивысшим приоритетом получают трафик первыми
Вес Число (1–100) Вес для weighted random балансировки. Больше вес — больше трафика

Поддерживаемые API форматы

Укажите, какие API форматы поддерживает нода нативно. Если формат не поддерживается — запросы будут автоматически конвертированы в Chat Completions.

Поле Описание
OpenAI Responses API (POST /v1/responses) Нода поддерживает OpenAI Responses API нативно
Anthropic Messages API (POST /v1/messages) Нода поддерживает Anthropic Messages API нативно

Ручной список моделей

Используется когда провайдер не поддерживает GET /v1/models (например MiniMax, некоторые DashScope-совместимые API). Укажите модели по одной на строку или через запятую.

При синхронизации, если /v1/models вернул 404, будет использован этот список.

  1. Нажмите Сохранить

После создания ноды:
- Если задан ручной список моделей — он применяется сразу без обращения к API
- Иначе — синхронизация моделей запускается автоматически через OpenaiNodeSyncService

Синхронизация моделей

RouterAI автоматически запрашивает список доступных моделей через эндпоинт /models. Синхронизация происходит:
- Автоматически при создании ноды
- При нажатии кнопки Синхронизировать на странице ноды или в списке нод
- Автоматически по расписанию (фоновая задача OpenaiNodeSyncJob)

Управление моделями

На странице ноды отображается список всех синхронизированных моделей с возможностью управления их доступностью.

Включение/отключение отдельной модели

Нажмите Включить или Выключить напротив нужной модели. Отключённые модели не участвуют в маршрутизации запросов.

Групповые операции

Выберите несколько моделей с помощью чекбоксов и используйте кнопки:
- Включить выбранные — активировать выбранные модели
- Выключить выбранные — деактивировать выбранные модели

Включение/отключение ноды

Используйте кнопку Включить/Выключить на странице ноды для временного отключения без удаления.

Страница ноды

На странице ноды отображается:
- Статус и признак включённости
- Базовый URL и наличие API ключа
- Время последней синхронизации и последнего health check
- Дата добавления
- Последняя ошибка синхронизации (если есть) с текстом сообщения
- Список доступных моделей с их статусами

Важные замечания

⚠️ API ключи хранятся в зашифрованном виде в базе данных.

⚠️ При редактировании ноды оставьте поле API Key пустым, чтобы сохранить текущий ключ без изменений.

⚠️ Если провайдер не поддерживает GET /v1/models — задайте модели вручную в настройках ноды.

Связанные разделы