Базовый URL OpenAI API для Open WebUI: руководство по настройке Flatkey

Настройка базового URL OpenAI API для Open WebUI — это небольшое поле, которое определяет, куда Open WebUI будет отправлять трафик чата: одному вышестоящему провайдеру, локальному серверу моделей или маршрутизатору, такому как Flatkey. При развертывании для команды это поле не следует рассматривать как деталь, которую можно просто скопировать и вставить. Его следует проверять вместе с API-ключом, идентификаторами моделей, поведением обнаружения моделей, завершениями чата, потоковой передачей и журналами использования.

Это руководство предназначено для разработчиков, команд по продуктам ИИ, создателей автоматизации, инженеров платформ, финансовых операторов и специалистов по закупкам, которые хотят, чтобы Open WebUI использовал Flatkey в качестве OpenAI-совместимого маршрутизатора моделей. В нем показан текущий путь подключения Open WebUI, базовый URL Flatkey для проверки, когда использовать фильтры моделей, как выполнить предварительную проверку с помощью curl и что нужно зафиксировать перед развертыванием настройки для большего числа пользователей.

Примечание к источнику: эта информация была проверена 29 июня 2026 года по официальной документации Open WebUI по OpenAI-совместимости, действующей главной странице Flatkey и действующей странице с ценами Flatkey. В этой среде выполнения не было доступно действующего API-ключа Flatkey или экземпляра Open WebUI, поэтому приведенные ниже команды являются шаблонами, которые следует выполнять с вашим собственным ключом, псевдонимом модели и развертыванием Open WebUI.

Краткий ответ: базовый URL OpenAI API для Open WebUI для Flatkey

Для маршрута Flatkey установите базовый URL OpenAI API для Open WebUI на текущий базовый URL провайдера Flatkey из вашей учетной записи. На общедоступной главной странице Flatkey, проверенной для этой статьи, указано, что OpenAI-совместимые клиенты следует направлять на https://console.flatkey.ai/v1. В Open WebUI используйте этот базовый URL, вставьте API-ключ Flatkey, добавьте точные идентификаторы моделей Flatkey, если обнаружение моделей работает с помехами или не удается, а затем сохраните соединение.

Коротко говоря: настройте URL, ключ и фильтр моделей, затем протестируйте запрос в чате и убедитесь, что запрос отображается в статистике использования Flatkey. Остальная часть этого руководства по базовому URL OpenAI API для Open WebUI превращает это в повторяемый контрольный список для настройки и устранения неполадок.

Что подтверждает текущая документация Open WebUI

В официальном руководстве Open WebUI по OpenAI-совместимости говорится, что Open WebUI может подключаться к любому серверу или провайдеру, который реализует OpenAI-совместимый API. Документация описывает интеграцию в рамках стандартных протоколов, особенно протокола OpenAI Chat Completions, а не через пользовательский модуль для каждого провайдера. Это делает настройку Flatkey задачей по конфигурированию базового URL, ключа и выбора модели.

В том же руководстве указан текущий путь администратора: откройте Open WebUI, перейдите в Настройки администратора, затем Соединения, затем OpenAI, а затем нажмите Добавить соединение. Там заполните URL провайдера и API-ключ. Если автоматическое обнаружение моделей не работает, добавьте идентификаторы моделей в поле Идентификаторы моделей (фильтр) и сохраните.

Одно предупреждение в Open WebUI особенно важно для настроек с маршрутизатором. При добавлении соединения Open WebUI проверяет его через конечную точку /models провайдера с помощью стандартного токена носителя (bearer token). В документации говорится, что некоторые провайдеры не реализуют /models, используют нестандартное поведение или возвращают громоздкий список моделей. Ошибка в списке моделей не означает автоматически, что завершения чата несовместимы. Это означает, что вам может потребоваться вручную добавить идентификаторы моделей и протестировать конечную точку чата напрямую.

Для полной совместимости Open WebUI указывает /v1/models как рекомендуемую конечную точку и /v1/chat/completions как обязательную основную конечную точку чата. Он также передает общие параметры OpenAI, такие как temperature, top_p, max_tokens или max_completion_tokens, stop, seed и logit_bias. Использование инструментов поддерживается, когда модель и сервер поддерживают tools и tool_choice.

Значения Flatkey, которые нужно проверить перед изменением Open WebUI

Главная страница Flatkey, проверенная 29 июня 2026 года, имеет заголовок One API gateway for production AI teams (Единый API-шлюз для производственных команд ИИ) и описывает унифицированный доступ к моделям, маршрутизацию, биллинг, аналитику использования и операционный контроль. Там также говорится, что команды должны направлять OpenAI-совместимый клиент на https://console.flatkey.ai/v1 и сохранять существующий SDK или шаблон клиента.

На странице цен Flatkey, проверенной в тот же день, указано, что в публичном каталоге доступно 633 модели от 23 провайдеров. Он также предоставляет семейства конечных точек, включая /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations и /v1/video/generations. Для чата Open WebUI начните с модели, которая доступна через путь завершения чата и одобрена для ключа, который вы планируете использовать.

Не стоит полагать, что каждая модель из каталога хорошо подходит для Open WebUI. Базовый URL OpenAI API для Open WebUI указывает на маршрутизатор, но пользовательский опыт зависит от выбранного псевдонима модели, поддержки конечных точек, задержки, поведения контекста, поддержки инструментов и того, корректно ли модель отображается в селекторе моделей Open WebUI.

Пошаговая инструкция: добавление Flatkey в качестве подключения OpenAI

1. Выберите область действия Open WebUI. Решите, будет ли это подключение для всех администраторов, тестовый экземпляр или развертывание на собственном хостинге, управляемое через переменные окружения.
2. Создайте или выберите ключ Flatkey. Используйте выделенный ключ для теста Open WebUI, чтобы можно было отслеживать и ограничивать использование.
3. Выберите одну стартовую модель. Скопируйте точный псевдоним модели со страницы цен Flatkey, из консоли Flatkey или из списка моделей, видимых в вашем аккаунте.
4. Откройте экран подключения. В Open WebUI перейдите в Настройки администратора > Подключения > OpenAI > Добавить подключение.
5. Вставьте URL-адрес Flatkey. Используйте https://console.flatkey.ai/v1, если это подтверждено в вашем аккаунте. Значение должно включать /v1, но не /chat/completions.
6. Вставьте ключ Flatkey. Используйте ключ, созданный для этого развертывания Open WebUI, а не личный ключ провайдера или ключ другого вышестоящего провайдера.
7. При необходимости добавьте идентификаторы моделей. Если обнаружение моделей не удается, возвращает слишком много вариантов или предоставляет модели, не соответствующие политике, добавьте точные утвержденные псевдонимы в поле Идентификаторы моделей (фильтр).
8. Сохраните и держите под рукой предыдущий маршрут. Open WebUI позволяет включать и отключать подключения, поэтому сохраните маршрут для отката на время тестирования.
9. Выполните один запрос с низким риском. Используйте простой запрос в Open WebUI, затем подтвердите его в статистике использования Flatkey по временной метке, ключу, модели, количеству токенов и стоимости.
10. Задокументируйте владельца. Запишите, кто владеет ключом, кто может его ротировать, какие модели одобрены и какая квота применяется, прежде чем расширять доступ.

Необязательный шаблон переменных окружения

Если ваше развертывание управляется через переменные окружения, используйте имена, поддерживаемые вашей версией Open WebUI и методом развертывания. Примеры провайдеров в Open WebUI показывают шаблоны OPENAI_API_BASE_URL и OPENAI_API_KEY для бэкендов, совместимых с OpenAI, но панель администратора также может управлять подключениями. Рассматривайте это как шаблон развертывания для сверки с вашей версией.

OPENAI_API_BASE_URL=https://console.flatkey.ai/v1
OPENAI_API_KEY=fk_замените_на_ключ_flatkey

Если вы также маршрутизируете через Open WebUI эмбеддинги, генерацию изображений, речь или другие функции в стиле OpenAI, настраивайте специфичные для этих функций переменные базового URL и ключа только после подтверждения, что Flatkey и выбранная модель поддерживают соответствующее семейство конечных точек. При первом развертывании базового URL OpenAI API для Open WebUI сосредоточьте тестирование на завершении чатов.

Предварительная проверка маршрута Flatkey, прежде чем винить Open WebUI

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

export FLATKEY_API_KEY="fk_замените_меня"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_OPEN_WEBUI_MODEL="замените-на-псевдоним-модели-flatkey"

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Верни слово ok."
      }
    ],
    "stream": false,
    "max_tokens": 16
  }'

Если этот запрос не удался, исправьте ключ Flatkey, URL, псевдоним модели, разрешения учетной записи или сетевой маршрут, прежде чем снова вносить изменения в Open WebUI. Если он выполнится успешно, повторите его через Open WebUI и сравните с журналом использования Flatkey.

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

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Выведи потоком три коротких пункта списка."
      }
    ],
    "stream": true,
    "max_tokens": 96
  }'

Контрольный список для обнаружения и фильтрации моделей

Самая безопасная настройка базового URL OpenAI API для Open WebUI предполагает намеренное использование фильтров моделей. Маршрутизатор может предоставлять много моделей, а администраторы не всегда хотят, чтобы пользователи видели обширный список.

Режимы сбоев для первоочередной отладки

Производственный план действий для Open WebUI и Flatkey

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

Место в кластере интеграции инструментов Flatkey

Open WebUI — это лишь одна из поверхностей, которая может использовать OpenAI-совместимый маршрут. Если ваша команда стандартизирует несколько инструментов, используйте один и тот же шаблон для всего кластера: один текущий базовый URL, один ключ, принадлежащий учетной записи, для каждой поверхности, точные псевдонимы моделей, небольшой дымовой тест, подтверждение использования и заметки по откату.

Для смежных настроек см. руководство по настройке API Cherry Studio для дисциплины базового URL настольного клиента, руководство CC Switch Claude Code Flatkey для маршрутизации инструментов разработчика и более широкое руководство по миграции OpenAI-совместимого API для изменений базового URL, проверки псевдонимов моделей и отката. Используйте цены Flatkey, чтобы ознакомиться с текущим покрытием моделей и эндпоинтов, а затем получите ключ для рабочего пространства, которому принадлежит первое развертывание Open WebUI.

Часто задаваемые вопросы

Что мне следует указать в поле базового URL OpenAI API для Open WebUI?

Используйте текущий базовый URL провайдера Flatkey из вашей учетной записи. Публичная домашняя страница Flatkey, проверенная 29 июня 2026 года, направляет OpenAI-совместимые клиенты на https://console.flatkey.ai/v1. Не включайте полный путь /chat/completions в поле базового URL.

Почему Open WebUI показывает ошибку обнаружения модели?

Open WebUI проверяет новое OpenAI-совместимое соединение, вызывая /models. Официальная документация предупреждает, что некоторые провайдеры не реализуют эту конечную точку, используют нестандартное поведение или возвращают очень большие списки моделей. Если завершения чата работают, добавьте точные идентификаторы моделей в фильтр и протестируйте снова.

Могу ли я предоставить Open WebUI доступ ко всем моделям Flatkey?

Технически маршрутизатор может предоставлять доступ ко многим моделям, но администраторам производственных сред следует начинать с узкого списка разрешенных. Выбирайте модели, которые соответствуют потребностям чата Open WebUI, поддержке конечных точек, ожиданиям по задержке, политике использования и контролю бюджета.

Заменяет ли Flatkey настройки Open WebUI?

Нет. Flatkey предоставляет OpenAI-совместимый маршрут, ключ, доступ к моделям, видимость использования и контроль биллинга. Open WebUI по-прежнему контролирует собственные настройки соединения, выбор модели, доступ пользователей, поведение промптов и сетевые настройки на уровне развертывания.

Как узнать, что настройка работает?

Выполните предварительный запрос curl к /chat/completions, сохраните соединение Open WebUI, отправьте один безопасный промпт и убедитесь, что запрос появился в статистике использования Flatkey с ожидаемым ключом, моделью, временной меткой, токенами, статусом и стоимостью.

Итоговый чек-лист

• Базовый URL Flatkey подтвержден из источника текущей учетной записи.
• Для развертывания Open WebUI создан выделенный ключ Flatkey.
• Сначала выбран один утвержденный псевдоним модели чата.
• Базовый URL OpenAI API для Open WebUI установлен на базовый URL провайдера, а не на полную конечную точку.
• Идентификаторы моделей добавлены вручную, если обнаружение не удалось или возвращает слишком много вариантов.
• Протестирован как потоковый, так и непотоковый чат.
• Строка использования Flatkey подтверждена после первого промпта в Open WebUI.
• Записаны владелец, квота, список разрешенных моделей и путь отката.

Как только эти проверки пройдены, базовый URL OpenAI API для Open WebUI становится больше, чем просто полем для подключения. Он становится контролируемым маршрутом Flatkey с одним ключом, утвержденными моделями, видимостью использования и четким планом отката.