Open WebUI с Claude и GPT через OpenAI-совместимый API

Open WebUI — самостоятельно размещаемый веб-интерфейс для чата, обычно запускаемый в Docker, с учётными записями, историей чатов, пресетами моделей и чатом по документам. Собственных облачных моделей у него нет. Вместо этого он подключается к любому серверу, который поддерживает протокол OpenAI Chat Completions, — именно его APIVAI предоставляет по адресу https://api.apivai.com/v1.

Руководство соответствует документации Open WebUI на октябрь 2026 года. Если подпись в вашей версии выглядит немного иначе, поля всё равно те же: URL, API-ключ и необязательный список ID моделей.

С облачными моделями Open WebUI работает через подключения OpenAI. Поля для собственного адреса Anthropic Messages в нём нет: встроенная поддержка Anthropic распознаёт только официальные адреса Anthropic. Поэтому правильный выбор — формат OpenAI:

• URL: https://api.apivai.com/v1 (с /v1, ровно один раз)
• Модели: Claude и GPT работают в этом формате, так что одно подключение обслуживает все модели со страницы цен

Адрес APIVAI в формате Anthropic (https://api.apivai.com, без /v1) нужен инструментам на Anthropic SDK, например Claude Code. В Open WebUI он не требуется. Подробнее о формате — на странице OpenAI-совместимый API.

1. Зарегистрируйтесь по email.
2. Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Подписки нет, оплата за токены.
3. В Панели создайте ключ и скопируйте его. Ключу можно задать собственный лимит бюджета — это удобно, когда одним экземпляром Open WebUI пользуется много людей.

1. Войдите в Open WebUI под учётной записью администратора.
2. Откройте Settings > Admin > Connections и найдите список Manage OpenAI API Connections.
3. Нажмите + Add Connection.
4. Заполните URL и API Key значениями из таблицы ниже. Connection Type оставьте External.
5. Нажмите Verify Connection рядом с полем URL. Open WebUI запросит /models с вашим ключом и должен показать Server connection verified.
6. Необязательно: раскройте Advanced. В поле Model IDs введите нужные ID (например, claude-sonnet-4-6) и нажимайте + после каждого. Если оставить поле пустым, в списке будут все модели, доступные ключу. Prefix ID добавляет к названию модели метку вроде apivai.; перед отправкой запроса Open WebUI её убирает. Provider оставьте Default.
7. Нажмите Save. Модели появятся в выборе моделей вверху нового чата.

При развёртывании в Docker те же значения можно передать переменными окружения при создании контейнера:

Если Ollama у вас не запущена, добавьте -e ENABLE_OLLAMA_API=False, чтобы Open WebUI перестал к ней обращаться. Чтобы ограничить список моделей через окружение, используйте OPENAI_API_CONFIGS — JSON-объект с ключами по номеру подключения и полями вроде model_ids и prefix_id.

Есть нюанс: это переменные типа ConfigVar. При значении по умолчанию ENABLE_PERSISTENT_CONFIG=True то, что сохранено в базе через панель администратора, важнее окружения. Если вы позже меняете OPENAI_API_BASE_URL и ничего не происходит, отредактируйте подключение в Settings > Admin > Connections.

Цены за миллион токенов на 2026-10-07. Список моделей меняется, поэтому берите ID из GET https://api.apivai.com/v1/models или со страницы цен, а не копируйте старые названия.

Если Open WebUI работает для команды, используйте список Model IDs, чтобы открыть только те модели, за которые вы готовы платить. Скрыть Opus от повседневных пользователей — самый простой способ сделать общий счёт предсказуемым.

Open WebUI делает небольшие фоновые запросы: пишет названия чатов, создаёт теги, предлагает следующие вопросы и дополняет ввод. По умолчанию они идут на модель текущего чата, так что чат с дорогой моделью оплачивает и свои названия по той же цене. В Settings > Admin > Interface укажите в External Task Model claude-haiku-4-5 или gpt-6-luna.

Фоновым запросам выделяется 1 000 выходных токенов, если не задать больше, и токены размышлений расходуют тот же бюджет. Если названия приходят пустыми или обрезанными, откройте Task Model Parameters > Configure в том же разделе и задайте max_tokens равным 4096.

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

Пример 1: один человек. Допустим, 40 сообщений в день в течение 30 дней, каждое примерно на 3 000 входных токенов (вопрос плюс история) и 800 выходных, на Claude Sonnet 4.6. Это 1 200 сообщений за $8.76 против $25.20 по официальным ценам.

Пример 2: команда из десяти человек. Десять человек по 40 сообщений в рабочий день за 22 рабочих дня — это 8 800 сообщений: $64.20 на Claude Sonnet 4.6 ($185 по официальной цене) или $21.49, если все пользуются Claude Haiku 4.5. Если модель задач работает на Claude Haiku 4.5 и на каждое сообщение приходится около двух фоновых запросов по 1 500 входных и 300 выходных токенов, это добавит примерно $18.43.

Панель показывает каждый запрос с токенами и стоимостью, так что через несколько дней эти допущения можно заменить своими цифрами. Более широкое сравнение цен — в статье Цены Claude API в 2026 году.

Чат с Claude и GPT полностью работает через APIVAI. С поиском по документам (RAG) иначе: для индексации файлов нужна модель эмбеддингов, а APIVAI эмбеддинги не предоставляет.

По умолчанию Open WebUI использует для эмбеддингов локальную модель SentenceTransformers (RAG_EMBEDDING_ENGINE не задан), поэтому загруженные документы продолжают работать без изменений. Просто не переключайте движок эмбеддингов на OpenAI с адресом APIVAI. Если нужны облачные эмбеддинги, настройте отдельного провайдера через RAG_OPENAI_API_BASE_URL и RAG_OPENAI_API_KEY или в Settings > Admin > Documents. Сами ответы по-прежнему даёт ваша модель чата через APIVAI. Генерации изображений и функциям речи тоже нужен свой провайдер.

• Verify Connection выдаёт 401: ключ неверный или скопирован не полностью. Скопируйте его заново из Панели, проверьте, что он не удалён и что бюджет ключа и ваш баланс не исчерпаны.
• 404: неверный URL. Нужен https://api.apivai.com/v1: не https://api.apivai.com без /v1, не /v1/v1, не полный путь вроде /v1/chat/completions и без косой черты в конце.
• Модель не найдена: в Model IDs указан несуществующий ID (часто старое или отображаемое название). Сверьте его с GET /v1/models. Модель с названием apivai.claude-sonnet-4-6 в порядке — это ваш Prefix ID.
• Пустые или обрезанные ответы: размышления включены по умолчанию, и их токены считаются выходными. Задайте max_tokens 4096 или больше в Advanced Params — для одного чата в Chat Controls или для всех на уровне модели в Workspace > Models.
• Переменные окружения будто игнорируются: их перекрывает значение, сохранённое в панели администратора (см. раздел про Docker выше).
• 429 Too Many Requests: по умолчанию 60 запросов в минуту на ключ, и фоновые задачи тоже считаются. Загруженной команде можно выдать пользователям отдельные ключи или попросить поддержку увеличить лимит.

Да. APIVAI отдаёт модели Claude в формате OpenAI по адресу https://api.apivai.com/v1, так что обычного подключения OpenAI в Open WebUI достаточно. Формат Anthropic нужен только инструментам на Anthropic SDK; см. руководство по настройке Claude Code.

Да. Один ключ APIVAI работает со всеми моделями со страницы цен. Пользователи переключают модели в выборе моделей вверху чата.

APIVAI не записывает содержимое запросов и ответов. История чатов Open WebUI хранится в его собственной базе данных на вашем сервере.

В Open WebUI есть и личные Direct Connections, которые пользователи добавляют в собственных настройках, — с тем же URL и своим ключом APIVAI. Другой вариант — оставить одно подключение администратора и задать этому ключу лимит бюджета в Панели.

Нет. APIVAI работает по предоплате без подписки; минимальное пополнение — $10, и вы платите только за использованные токены. Настройка других инструментов описана в документации и в нашем руководстве по LobeChat.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Open WebUI.