# Как создать API-ключ Open WebUI и проверить доступ к моделям

Источник: https://modelium.tech/zhurnal/open-webui-api-key-dlya-skripta/

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

Хотите, чтобы ваш скрипт увидел модели в уже запущенном Open WebUI? Создайте **API-ключ** — секрет для обращения к интерфейсу без повторного входа через браузер — и проверьте запросом список доступных моделей. Это **не ключ Ollama или облачного провайдера**: он действует от имени вашего аккаунта Open WebUI. [s1](#src-s1) [s2](#src-s2)

**Инженерная инструкция по документации и исходному коду Open WebUI v0.12.2, сверенным 16 октября 2026 года.** Редакция не запускала Open WebUI, не создавала действительный ключ и не проверяла ответ модели. Понадобятся уже работающий экземпляр, доступ к своему аккаунту и компьютер с Linux, Bash и `curl` для шага проверки; в примере интерфейс доступен на `http://localhost:3000`. Если у вас иной адрес, замените его на свой. Сам API-ключ не превращает подключённую облачную модель в локальную. [s1](#src-s1) [s2](#src-s2)

## Как получить ключ, не сломав старую интеграцию?

- **Сначала спросите, используется ли ключ этого аккаунта другим скриптом.** У одного аккаунта Open WebUI только один действительный API-ключ: кнопка **Create new key** заменяет его и сразу останавливает старую интеграцию. Если нужна независимая автоматизация, используйте отдельный аккаунт с минимально необходимыми правами; не создавайте новый ключ поверх рабочего. [s1](#src-s1)

- В Open WebUI откройте значок профиля → **Settings → Account**, разверните **Secrets** кнопкой **Show**. Если ключ уже есть, не нажимайте **Create new key** ради просмотра: скопируйте существующий только если вы отвечаете за его использование. Если ключа нет, нажмите **Create new secret key**, затем скопируйте значение. Не публикуйте его и не вставляйте в адресную строку или чат. [s1](#src-s1)

- Если раздела API Keys совсем нет, администратору надо включить **API Keys** в настройках **Authentication**; пользователю без роли администратора ещё требуется разрешение **API Keys** в группе или общих правах. Сообщение `API key creation is not allowed` — повод проверить эти настройки, а не забирать чужой ключ. [s1](#src-s1) [s3](#src-s3)

## Как проверить доступ только к списку моделей?

Откройте **Bash на Linux** на том же компьютере, где доступен Open WebUI. Введите `read -rs -p 'Ключ Open WebUI: ' OWUI_KEY; printf '\n'`, вставьте скопированный ключ и нажмите Enter. Ввод не показывается на экране и сам ключ не записывается в текст команды. Затем выполните `curl -sS -i -H "Authorization: Bearer ${OWUI_KEY}" http://localhost:3000/api/models`; после проверки — `unset OWUI_KEY`. Для другого адреса замените только `http://localhost:3000` на **свой адрес Open WebUI**; не передавайте секрет по обычному HTTP через внешнюю сеть. [s1](#src-s1) [s2](#src-s2)

Ожидаемая проверка: ответ **HTTP 200** и JSON со списком моделей; если список пуст, это ещё не доказательство ошибки ключа — проверьте подключение модели отдельно. Пример учебной задачи без действительного секрета: программа читает доступные имена моделей, вы сверяете одно из них со списком в интерфейсе. **Генерацию ответа модели этот запрос не проверяет** и офлайн-режим не подтверждает. [s2](#src-s2)

## Что делать при отказе и как ограничить риск?

- **HTTP 401:** проверьте, не скопировали ли устаревший ключ после замены, и передаётся ли он как `Authorization: Bearer ...`. Не печатайте ключ в диагностический лог. [s1](#src-s1) [s4](#src-s4)

- **HTTP 403:** проверьте глобальный переключатель, разрешение пользователя и, если администратор включил ограничение маршрутов, наличие `/api/models` в общем разрешённом списке. Ограничение маршрутов действует на весь экземпляр, а не на один ключ. [s1](#src-s1) [s4](#src-s4)

- **Ключ больше не нужен или раскрыт:** удалите его или замените в настройках аккаунта. Существующий ключ не имеет автоматического срока действия; замена и удаление отключают старое значение. Не выдавайте ключ администратора обычному скрипту: он наследует права владельца аккаунта. [s1](#src-s1)

[Начните с настройки самой модели в Open WebUI](/zhurnal/open-webui/), если в проверке ещё нечего перечислять. **Не путайте список в API с ответом модели:** успешный запуск проверяют отдельным учебным вопросом по выбранному локальному подключению. [s2](#src-s2)

## Источники

1. [Open WebUI Docs — API Keys, закреплённая ревизия](https://github.com/open-webui/docs/blob/03d9698064202570806cc800d01d5804f5c272f2/docs/features/authentication-access/api-keys.md) — получено 2026-10-16
2. [Open WebUI Docs — API Endpoints, закреплённая ревизия](https://github.com/open-webui/docs/blob/03d9698064202570806cc800d01d5804f5c272f2/docs/reference/api-endpoints.md) — получено 2026-10-16
3. [Open WebUI v0.12.2 — выдача и проверка API-ключа](https://github.com/open-webui/open-webui/blob/6a18585ff4c2e5f6805f682222cfbc46dc669ef8/backend/open_webui/routers/auths.py) — получено 2026-10-16
4. [Open WebUI v0.12.2 — проверка ключа на каждом запросе](https://github.com/open-webui/open-webui/blob/6a18585ff4c2e5f6805f682222cfbc46dc669ef8/backend/open_webui/utils/auth.py) — получено 2026-10-16