Перейти к содержимому

Подключение 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 Studiohttp://localhost:1234/v1
vLLMhttp://localhost:8000/v1
llama.cpp serverhttp://localhost:8080/v1
LiteLLM proxyhttp://localhost:4000
  1. В Thunderbird откройте Настройки atbridge: через шестерёнку или Инструменты → Дополнения и темы → atbridge.ai → Настройки (см. Открытие настроек расширения atbridge). Перейдите на вкладку Провайдеры ИИ.

  2. В выпадающем списке Провайдер выберите OpenAI-совместимый (свой URL).

  3. Заполните поле Base URL и вставьте ключ в поле Ключ API. Ключ шифруется на этом устройстве и никогда не попадает на серверы atbridge.ai.

  4. Нажмите Подключить. 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?