Настройка провайдеров

AQBot одновременно подключается к любому количеству ИИ-провайдеров. У каждого провайдера есть собственные ключи API, список моделей и параметры по умолчанию.

Поддерживаемые провайдеры

Провайдер	Примеры моделей
OpenAI	GPT-4o, GPT-4, o3, o4-mini
Anthropic	Claude 4 Sonnet, Claude 4 Opus, Claude 3.5 Sonnet
Google	Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0
DeepSeek	DeepSeek V3, DeepSeek R1
Alibaba Cloud	Серия Qwen
Zhipu AI	Серия GLM
xAI	Серия Grok
OpenAI-совместимый API	Ollama, vLLM, LiteLLM, сторонние ретрансляторы и т.д.

---

Добавление провайдера

1. Перейдите в Настройки → Провайдеры.
2. Нажмите кнопку + в нижнем левом углу.
3. Заполните данные провайдера:

Поле	Описание
Имя	Отображаемое имя для боковой панели (например, OpenAI)
Тип	Тип провайдера — определяет Base URL по умолчанию
Иконка	Опциональная иконка для визуальной идентификации
API-ключ	Секретный ключ из панели вашего провайдера
Base URL	API-endpoint (предзаполнен для встроенных типов)
Путь API	Путь запроса — по умолчанию /v1/chat/completions

---

Импорт по ссылке с сайта

Сайты провайдеров, панели relay-сервисов, частные платформы моделей или локальные gateway-страницы могут предоставлять ссылку Открыть в AQBot. После клика браузер запускает настольное приложение AQBot, AQBot переходит в Настройки → Провайдеры, показывает окно подтверждения и импортирует конфигурацию только после подтверждения пользователем.

Сценарий пользователя

1. Установите и откройте версию AQBot, которая поддерживает ссылки провайдеров.
2. В браузере нажмите ссылку Открыть в AQBot на странице провайдера.
3. Проверьте в AQBot имя провайдера, Base URL, тип провайдера и префикс API-ключа.
4. AQBot повторно использует существующего провайдера с тем же сочетанием Base URL + тип. Если такого провайдера нет, он будет создан, а API-ключ будет добавлен только если его еще нет.

AQBot не проверяет ключ и не загружает модели автоматически. После импорта нажмите Получить модели или добавьте модели вручную.

Формат ссылки

aqbot://providers?name=<name>&baseurl=<base-url>&apikey=<api-key>&type=<provider-type>

Пример:

aqbot://providers?name=OpenAI&baseurl=https%3A%2F%2Fapi.openai.com&apikey=sk-xxx&type=openai

Параметры

Параметр	Обязателен	Описание
name	Да	Отображаемое имя в AQBot, например OpenAI или My Relay
baseurl	Да	URL-кодированный Base URL. Разрешены только http и https; query и hash отклоняются.
apikey	Да	API-ключ для сохранения в AQBot. В окне подтверждения AQBot показывает только префикс.
type	Да	Тип провайдера. Допустимые значения: openai, openai_responses, anthropic, gemini, custom.

baseurl может использовать существующий force-суффикс AQBot, например https://example.com!. При импорте по ссылке api_path не задается; AQBot продолжает использовать путь по умолчанию для выбранного типа провайдера.

Настройка сайта

Кодируйте все динамические значения с помощью encodeURIComponent или URLSearchParams:

<a id="open-aqbot" href="#">Открыть в AQBot</a>

<script>
  const provider = {
    name: 'My Relay',
    baseurl: 'https://api.example.com',
    apikey: 'sk-user-key',
    type: 'openai',
  };

  const params = new URLSearchParams({
    name: provider.name,
    baseurl: provider.baseurl,
    apikey: provider.apikey,
    type: provider.type,
  });

  document.getElementById('open-aqbot').href = `aqbot://providers?${params.toString()}`;
</script>

Если ваш сервис позволяет создавать API-ключи онлайн, формируйте ссылку только после входа пользователя и явного выбора или создания ключа.

Безопасность

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

Тестирование

aqbot:// — пользовательский протокол, который регистрируется установленным настольным приложением. Один только сайт или dev-сервер Vite не регистрирует этот протокол. Если ссылка не открывает AQBot, сначала установите или пересоберите последнюю настольную версию AQBot.

---

Импорт из CC Switch

AQBot может сканировать конфигурации провайдеров CC Switch в Settings -> Providers. Проверьте кандидатов, выберите импортируемые строки и импортируйте providers, Base URLs, API keys и model lists. OAuth-only entries и записи без reusable keys пропускаются с видимой причиной.

Расширенное тело запроса модели

Для каждой модели можно задать extra_body, JSON-объект, который добавляется в OpenAI-compatible Chat Completions request. Это удобно для provider-specific options вроде enable_thinking. AQBot валидирует JSON и блокирует перезапись model, messages, stream, tools и базовых sampling fields.

Ротация нескольких ключей

AQBot поддерживает несколько ключей API на провайдера. Нажмите Добавить ключ в панели деталей провайдера.

---

Управление моделями

Нажмите Получить модели для загрузки полного списка доступных моделей. Вы также можете вводить ID моделей вручную.

Каждая модель может иметь собственные параметры по умолчанию: температура, максимальное количество токенов, Top P, штраф за частоту, штраф за присутствие.

---

Ollama (локальные модели)

1. Установите и запустите Ollama.
2. В AQBot создайте нового провайдера с типом OpenAI.
3. Установите Base URL равным http://localhost:11434.
4. Нажмите Получить модели для обнаружения локально загруженных моделей.

---

Следующие шаги

• MCP-серверы — подключение внешних инструментов для расширения возможностей ИИ
• API-шлюз — предоставление провайдеров как локального API-сервера