Как подключить Open WebUI к API429

Подготовьте серверное соединение

Сначала определите, кто администрирует вашу установку и кто сможет пользоваться добавленным соединением. Серверный ключ оплачивает запросы всех допущенных пользователей, поэтому заранее ограничьте доступ средствами вашего приложения. Личный ключ пользователя и общий ключ развёртывания решают разные задачи: не публикуйте общий секрет в инструкции для сотрудников, экспортируемом чате или доступном репозитории. Перед изменением сохраните несекретные параметры прежнего соединения, чтобы было понятно, какие настройки вы меняете.

На сервере включите ENABLE_OPENAI_API и задайте OPENAI_API_BASE_URLS адресом https://gateway.api429.com/v1. Значение OPENAI_API_KEYS должно поступать из защищённого окружения процесса. Пример ниже показывает буквальную заглушку, которую нельзя отправлять как настоящий ключ. Это лист параметров для администратора, а не команда установки. Он не предполагает, что docker --env-file подставляет переменные оболочки внутрь файла.

Оставьте одну явно выбранную модель

В OPENAI_API_CONFIGS ключ «0» обозначает первое соединение из списка адресов. Поле enable включает именно его, а model_ids задаёт список для этого соединения. Не добавляйте prefix_id на первом шаге: сначала проверьте точный идентификатор без собственного префикса. Если в установке уже есть соединения, не перезаписывайте их этим образцом: согласуйте индекс, адрес и соответствующий ключ с администратором.

Несколько адресов и несколько ключей в соответствующих переменных разделяются точкой с запятой; порядок имеет значение для настройки соединений. Для начальной проверки достаточно одного адреса и одного ключа. Ручной список моделей облегчает выбор, но не предоставляет доступ. Наличие записи в публичном каталоге нужно отдельно сопоставить с авторизованным GET /v1/models для вашего ключа; не включайте секрет в диагностический отчёт.

Проверьте сохранённые настройки и фоновые задачи

Официальный справочник помечает эти параметры как сохраняемые настройки ConfigVar. После первого запуска сохранённые настройки могут иметь приоритет над изменённым окружением. Если адрес остался прежним, проверьте соединение в административном интерфейсе, а не повторяйте сообщения в чат. Обновление через интерфейс сохраняется; отключение постоянной конфигурации влияет на всю установку. Для этого подключения не требуется удалять базу или пользовательские данные.

Генерация названия, тегов и предложений продолжения — отдельные документированные задачи. В образце они выключены переменными ENABLE_TITLE_GENERATION, ENABLE_TAGS_GENERATION и ENABLE_FOLLOW_UP_GENERATION. TASK_MODEL_PARAMS задаёт max_tokens для оставшихся фоновых задач, но не ограничивает основной ответ чата. Проверьте также действующие настройки интерфейса. Отключение этих трёх задач не доказывает отсутствие всех дополнительных вызовов: расширения, поиск и другие функции требуют отдельной проверки.

Отправьте короткий текст и оцените результат

Выберите добавленную модель и новый обычный чат без файлов, поиска, инструментов и расширений. В доступных вашей версии параметрах ответа установите max_tokens равным 256, отключите потоковую выдачу для начальной проверки и отправьте одно несекретное предложение. Контрольный JSON ниже показывает обычный клиентский контракт API429, а не импортируемые настройки Open WebUI. Убедитесь, что приложение действительно применило параметры; одно нажатие в интерфейсе нельзя заранее считать одним платным вызовом.

Полученный текст проверьте вместе с расходом в кабинете API429. Генерация платная, включая возможные дополнительные обращения клиента. Ограничение числа токенов ответа не устанавливает общий бюджет: входной контекст, количество сообщений и фоновые задачи тоже влияют на общую стоимость. При ошибке адреса сначала сравните конечный путь /v1/chat/completions; при отказе доступа проверьте ключ и точный ID, затем делайте новый осознанный запуск.

Границы первого подключения

Оставьте ENABLE_OPENAI_API_PASSTHROUGH выключенным. Для обычного чата он не нужен; справочник описывает отдельный универсальный прокси, использующий административный ключ. Настроенный список моделей и доступ пользователей необходимо проверять независимо. Эта инструкция не подтверждает работу инструментов, изображений, схем ответа, агентных циклов или потоковой обработки в установленном клиенте. Для расширения сценария сначала сверяйте конкретный метод и возможности выбранной модели, сохраняя первоначальный текстовый тест как отдельную проверку.

Параметры окружения сервера; ключ — буквальная заглушка

ENABLE_OPENAI_API=True
OPENAI_API_BASE_URLS=https://gateway.api429.com/v1
OPENAI_API_KEYS=YOUR_API429_KEY
OPENAI_API_CONFIGS={"0":{"enable":true,"model_ids":["gemini-3.8-flash"]}}
ENABLE_TITLE_GENERATION=False
ENABLE_TAGS_GENERATION=False
ENABLE_FOLLOW_UP_GENERATION=False
TASK_MODEL_PARAMS={"max_tokens":256}
ENABLE_OPENAI_API_PASSTHROUGH=False

Контрольный контракт обычного текста; не импорт Open WebUI

{
  "model": "gemini-3.8-flash",
  "messages": [
    {
      "role": "user",
      "content": "Ответь одним предложением: что такое API?"
    }
  ],
  "max_tokens": 256,
  "stream": false
}

Оплата и тест $10

• Карта российского банка. Пополнение баланса в личном кабинете.
• Счёт для юрлиц. Безналичная оплата с закрывающими документами.
• USDT и TON. Пополнение криптовалютой.

Тест $10. Подпишитесь на наш Telegram-канал через бота — получите $10 на баланс для первых запросов. Получить $10 в боте