Открыть настройку API WebUI

Добавьте TokenHub в Open WebUI в качестве соединения, совместимого с OpenAI, выберите модель и подтвердите запрос на чат.

Создать ключ API TokenHub

Что такое открытый веб-интерфейс?

Open WebUI — это автономный интерфейс для общения с моделями ИИ и подключения поставщиков моделей, совместимых с OpenAI.

Эта настройка Open WebUI добавляет TokenHub из панели подключения администратора. Он использует протокол OpenAI Chat Completions и предоставляет список разрешенных моделей вручную, если поставщик не предоставляет /models. Соединение находится на панели подключений администратора, где один OpenAI-совместимый провайдер может предоставлять пользователям одну или несколько моделей. Если автоматическое обнаружение модели недоступно, используйте список разрешенных моделей вместо того, чтобы предполагать, что конечная точка чата сломана, и проверьте доступ к сети изнутри контейнера Open WebUI при самостоятельном размещении с помощью Docker.

Open WebUI управляет службами модели по протоколу вместо того, чтобы требовать отдельный плагин для каждого поставщика. Добавьте TokenHub как OpenAI API Connection. Затем Open WebUI добавляет /models и /chat/completions к базе API URL.

Добавьте TokenHub в раздел «Подключения администратора».

Это соответствует официальной последовательности Step 1: Add Your Provider Connection Open WebUI:

  1. Войдите в Open WebUI под учетной записью администратора.
  2. Перейдите к Settings → Admin → Connections.
  3. Найдите Manage OpenAI API Connections и нажмите Add Connection (кнопка «плюс»).
  4. Введите https://us-api.tokenhub.com/v1 в URL.
  5. Введите свой ключ TokenHub API в API Key.
  6. Если проверка соединения не возвращает ни одной модели, введите точный идентификатор модели TokenHub в поле Model IDs (Filter) и нажмите кнопку «плюс», чтобы добавить ее в белый список.
  7. Нажмите Save.

Не помещайте /chat/completions в URL. Open WebUI сам добавляет пути запроса, поэтому полный запрос URL создает дублированный путь.

Общие сведения о проверке идентификаторов соединения и модели (фильтр)

Перед сохранением Open WebUI отправляет стандартный запрос токена-носителя на конечную точку /models провайдера. В его документации отмечается, что некоторые совместимые службы возвращают 400, 401 или 403 на этот запрос на обнаружение, даже если завершение чата работает. Тестируйте в таком порядке:

  1. Добавьте идентификатор модели вручную в Model IDs (Filter) и сохраните.
  2. Начните новый чат и убедитесь, что модель появилась в селекторе.
  3. Выберите его и отправьте сообщение, чтобы протестировать реальный запрос на завершение чата.

Добавляйте каждый идентификатор модели только один раз. Open WebUI обрезает окружающие пробелы. Переключатель рядом с соединением временно отключает провайдера, не удаляя его настройки.

Не заменяйте host.docker.internal на удаленный API.

Официальный совет host.docker.internal применим только в том случае, если контейнер Open WebUI должен достичь сервера модели, работающего на хосте Docker. TokenHub — это удаленная служба HTTPS, поэтому сохраните https://us-api.tokenhub.com/v1. Если истекло время ожидания только для контейнера, проверьте его разрешение DNS, исходящий доступ HTTPS и конфигурацию прокси-сервера, а не меняйте URL на localhost.

Убедитесь, что запрос Open WebUI действительно отправляется.

  1. Создайте чат и выберите модель TokenHub, которую вы добавили в белый список.
  2. Сначала отправьте короткое текстовое сообщение.
  3. В журналах запросов TokenHub подтвердите, что путь — /v1/chat/completions, идентификатор модели точный и использование записано.
  4. Только после того, как базовый чат заработает, тестируйте инструменты, изображения и функции знаний отдельно. Элемент управления в Open WebUI не гарантирует, что выбранная модель или совместимая конечная точка поддерживают эту возможность.

Для ошибки 404 сначала убедитесь, что URL заканчивается на /v1. Если модель отсутствует, вернитесь к Model IDs (Filter). Если сбой происходит только в Docker, проверьте сеть контейнера.

Официальная ссылка

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

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Часто задаваемые вопросы по настройке Open WebUI API

Как добавить API-интерфейс, совместимый с OpenAI, в Open WebUI?

Откройте «Настройки» → «Администратор» → «Подключения» и добавьте подключение в разделе «Управление подключениями OpenAI API». Введите URL-адрес TokenHub/v1 и ключ API, затем сохраните его.

Должен ли URL-адрес Open WebUI включать /chat/completions?

Нет. Используйте корень API, заканчивающийся на /v1; Open WebUI создает путь запроса для каждой операции.

Почему список моделей Open WebUI пуст?

Если обнаружение модели недоступно, добавьте точный идентификатор модели TokenHub в разделе «Идентификаторы модели» (Фильтр), сохраните и снова откройте инструмент выбора модели нового чата.

Почему Dockerized Open WebUI не может достичь TokenHub?

Проверьте DNS, прокси-сервер, сертификаты и исходящий доступ изнутри контейнера Open WebUI. Соединение хоста с браузером не доказывает, что контейнер имеет доступ к сети.

Как проверить, что Open WebUI использует TokenHub?

Выберите настроенную модель в новом чате, отправьте короткое сообщение и подтвердите идентификатор модели, статус и использование токена в журналах запросов TokenHub.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。