Heli + Open WebUI: OpenAI-совместимое подключение

Подключение через интерфейс

Open WebUI сам запрашивает GET /v1/models с вашим ключом, поэтому неверный URL или ключ видны сразу: список моделей остаётся пустым. Для загрузки документов в базу знаний задайте в настройках документов движок эмбеддингов OpenAI с тем же URL и ключом и модель openai/text-embedding-3-small.

• Зарегистрируйтесь на getheli.ru (подтверждение почты или вход через Google / Яндекс ID), пополните баланс и создайте ключ на вкладке «Ключи» кабинета.
• В Open WebUI войдите под администратором: Settings → Admin → Connections, список Manage OpenAI API Connections.
• Нажмите ➕ Add Connection. URL: https://getheli.ru/v1 — без /chat/completions на конце. API Key: ваш ключ sk-heli-….
• Model IDs (Filter): перечислите нужные слаги, например anthropic/claude-sonnet-5 и google/gemini-3.5-flash. Каталог Heli большой, и без фильтра в выпадающем списке окажутся сотни моделей.
• Нажмите Save, откройте новый чат и выберите модель в списке сверху.

Подключение через переменные окружения

Для Docker-развёртывания соединение удобно задать при первом запуске. Значения из переменных попадают в настройки, дальше их можно менять в админке.

# docker-compose.yml, сервис open-webui
environment:
  - OPENAI_API_BASE_URL=https://getheli.ru/v1
  - OPENAI_API_KEY=sk-heli-ВАШ_КЛЮЧ

# Проверка ключа и слага до настройки интерфейса
curl https://getheli.ru/v1/chat/completions \
  -H "Authorization: Bearer sk-heli-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/gemini-3.5-flash", "messages": [{"role": "user", "content": "ping"}]}'

Какие модели выбрать

Для команды обычно хватает двух-трёх моделей: сильной для анализа и кода, быстрой для повседневных вопросов и отдельной модели эмбеддингов для документов. Служебные задачи Open WebUI — генерацию заголовков чатов и тегов — тоже выполняет модель, поэтому назначьте для них быструю.

Claude Sonnet 5 — анализ документов, код, длинный контекст.

Gemini 3.5 Flash — быстрые ответы и служебные задачи интерфейса.

text-embedding-3-small — эмбеддинги для загруженных документов.

Частые ошибки

• Список моделей пустой — проверьте URL: нужен https://getheli.ru/v1, без лишних сегментов пути и пробелов.
• 401 Incorrect API key — ключ неверный или отозван; создайте новый на вкладке «Ключи» и обновите соединение.
• 402 insufficient_balance — закончился баланс; пополните его, соединение перенастраивать не нужно.
• Ошибка о несуществующей модели — слаг в фильтре должен совпадать с id из GET /v1/models, включая префикс вендора.
• Долгие ответы обрываются — включите потоковый вывод и уменьшите объём документов, которые попадают в контекст.

Документация API

Оплата — пополнение баланса в рублях.

Какую модель выбрать для RAG