Подключение OpenAI-совместимого API
Многие AI-сервисы и серверы работают в том же формате API, что и OpenAI. atbridge.ai поддерживает их все через один вариант провайдера — OpenAI-совместимый (свой URL). Ничего не нужно устанавливать и ждать отдельной интеграции: введите Base URL сервиса и ключ API, и atbridge AI Chat будет работать с ним, как с любым другим провайдером.
Типичные случаи:
- Модель на вашем компьютере или сервере: LM Studio, vLLM, сервер llama.cpp, LocalAI.
- Прокси, который развернула ваша компания, например LiteLLM перед несколькими провайдерами.
- API-шлюз или реселлер, дающий доступ к моделям через OpenAI-совместимый эндпоинт.
Что понадобится
Заголовок раздела «Что понадобится»- Base URL: адрес API из документации вашего провайдера. Это то же значение,
которое в OpenAI SDK называется
base_url, напримерhttps://llm.example.com/v1. Вставьте его в точности как в документации; atbridge.ai принимает его как с завершающим/v1, так и без него. - Ключ API: создаётся в личном кабинете провайдера. Локальный сервер, который
не проверяет ключи, примет любое значение-заглушку, например
local.
Сервис должен поддерживать два стандартных эндпоинта OpenAI с аутентификацией
Authorization: Bearer: /v1/chat/completions (сам чат) и /v1/models (список
моделей, по которому atbridge.ai также проверяет соединение). Почти все
OpenAI-совместимые сервисы и локальные серверы поддерживают оба.
Распространённые локальные серверы и их обычные Base URL (сверьтесь со своей установкой):
| Сервер | Обычный base URL |
|---|---|
| LM Studio | http://localhost:1234/v1 |
| vLLM | http://localhost:8000/v1 |
| llama.cpp server | http://localhost:8080/v1 |
| LiteLLM proxy | http://localhost:4000 |
Добавьте его в atbridge.ai
Заголовок раздела «Добавьте его в atbridge.ai»-
В Thunderbird откройте Настройки atbridge: через шестерёнку или Инструменты → Дополнения и темы → atbridge.ai → Настройки (см. Открытие настроек расширения atbridge). Перейдите на вкладку Провайдеры ИИ.
-
В выпадающем списке Провайдер выберите OpenAI-совместимый (свой URL).
-
Заполните поле Base URL и вставьте ключ в поле Ключ API. Ключ шифруется на этом устройстве и никогда не попадает на серверы atbridge.ai.
-
Нажмите Подключить. atbridge.ai сразу проверяет адрес и ключ, запрашивая список моделей. Если проверка прошла, статус сменится на зелёную ✓; если нет, ничего не сохраняется, и вы увидите причину.
Выберите модель и общайтесь
Заголовок раздела «Выберите модель и общайтесь»Откройте atbridge AI Chat (кнопка @b в Thunderbird) и выберите модель в выпадающем списке моделей, где показаны модели, которые сообщает сервис. Шлюз может выдавать сотни моделей; чтобы использовать модель по точному названию, введите его в поле свой идентификатор модели в разделе Настройки → Предпочитаемые провайдер и модель ИИ.
Кто видит ваши данные
Заголовок раздела «Кто видит ваши данные»С OpenAI-совместимым провайдером ваши запросы, а также текст писем и вложения, которые вы передаёте AI Chat, отправляются на указанный вами Base URL. atbridge.ai не пропускает их через свои серверы и не хранит. Прежде чем подключать сервис, убедитесь, что доверяете тем, кто его обслуживает, и прочитайте его условия конфиденциальности и хранения данных. Для почты, которая не должна покидать ваш компьютер, используйте локальный сервер (таблица выше) или Ollama.
Настройка из командной строки
Заголовок раздела «Настройка из командной строки»То же подключение из терминала; ключ читается из стандартного ввода, поэтому не попадает в историю оболочки:
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \ --base-url https://llm.example.com/v1 --key-stdinЕсли не удаётся подключиться
Заголовок раздела «Если не удаётся подключиться»- 404 или «not found»: неверный Base URL. Скопируйте его заново из
документации провайдера; обычно это адрес, который заканчивается на
/v1. - 401 или 403: ключ неверный, просрочен или не имеет доступа к этой модели.
- URL верный, но Подключить всё равно не срабатывает: возможно, сервис не
отдаёт список моделей (
/v1/models), который нужен atbridge.ai для проверки соединения. Уточните у провайдера, поддерживает ли он его. - Чат отвечает, но никогда не заглядывает в вашу почту: модель не поддерживает вызов инструментов. Выберите другую модель.
Похожее
Заголовок раздела «Похожее»Was this page helpful?
Thanks for the feedback!