設定服務供應商

AQBot 支援接入多種 AI 服務供應商，您可以同時設定多個服務供應商並在對話中自由切換。

支援的服務供應商

AQBot 內建以下服務供應商類型，並支援任何相容 OpenAI API 格式的自訂端點：

新增服務供應商

基本步驟

1. 進入 設定 → 服務供應商
2. 點擊左下角的 + 按鈕
3. 填寫以下資訊：
   • 名稱 — 自訂名稱，用於在介面中區分不同服務供應商
   • 類型 — 選擇對應的服務供應商類型（如 OpenAI、Anthropic 等）
   • 圖示 — 可選，為服務供應商選擇一個顯示圖示
4. 點擊確認建立

設定 API

建立服務供應商後，需要填寫 API 連線資訊：

API 金鑰

填入從服務供應商處取得的 API 金鑰。例如 OpenAI 的金鑰格式為 sk-...。

Base URL

API 的基礎位址。各服務供應商的官方位址：

如果您使用第三方中繼服務或自建代理，將 Base URL 替換為中繼位址即可。

API 路徑

API 請求的路徑部分，預設為 /v1/chat/completions。一般情況下無需修改，除非服務供應商使用了非標準路徑。

從網頁連結匯入服務供應商

服務供應商官網、中繼服務後台、私有模型平台或本機閘道頁面，可以提供一個 在 AQBot 中開啟 的連結。使用者點擊後，瀏覽器會喚起 AQBot 桌面端，AQBot 會進入 設定 → 服務供應商，顯示確認視窗，並在使用者確認後匯入服務供應商設定。

使用流程

1. 安裝並開啟支援服務供應商連結匯入的 AQBot 版本。
2. 在瀏覽器中點擊服務頁面提供的 在 AQBot 中開啟 連結。
3. 在 AQBot 確認視窗中檢查服務供應商名稱、Base URL、服務供應商類型和 API Key 前綴。
4. 確認後，AQBot 會按 Base URL + 類型 重用既有服務供應商；如果不存在則建立新服務供應商，並在金鑰不存在時追加 API Key。

AQBot 不會自動驗證 API Key，也不會自動同步模型清單。匯入後可點擊 取得模型，或手動新增模型 ID。

連結格式

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

參數說明

baseurl 支援 AQBot 既有的強制後綴語義，例如 https://example.com!。透過連結匯入時不會設定 api_path，AQBot 會繼續按所選服務供應商類型使用預設路徑邏輯。

官網/後台頁面如何設定連結

對所有動態值使用 encodeURIComponent 或 URLSearchParams 進行編碼：

<a id="open-aqbot" href="#">在 AQBot 中開啟</a>
<script>
  const provider = {
    name: '我的中繼服務',
    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 Key，建議只在使用者登入後，且明確選擇或建立金鑰後再產生此連結。

從 CC Switch 匯入

在 設定 -> 服務供應商 中，AQBot 可以掃描 CC Switch 的服務供應商設定。你可以逐條檢查候選項，選擇可匯入記錄後，把服務供應商、Base URL、API Key 和模型列表匯入 AQBot。OAuth-only 或沒有可復用金鑰的記錄會被跳過並顯示原因。

進階模型請求體

每個模型都可以設定 extra_body，這是一個 JSON 物件，會平鋪追加到 OpenAI 相容 Chat Completions 請求體中。它適合 enable_thinking 等廠商私有參數。AQBot 會校驗 JSON，並阻止覆蓋 model、messages、stream、tools 和基礎採樣欄位。

多金鑰輪詢

AQBot 支援為同一個服務供應商設定多個 API 金鑰，實現自動輪換：

新增多個金鑰

在服務供應商設定頁面的 API 金鑰區域，可以新增多個金鑰。所有金鑰共享同一個 Base URL 和設定。

自動輪換機制

當設定了多個金鑰時，AQBot 會在每次請求時自動輪換使用不同的金鑰。

限流分散

多金鑰輪詢的一個重要用途是分散 API 限流。每個金鑰有獨立的速率配額，使用多個金鑰可以有效提高整體吞吐量，降低單個金鑰觸發限流的概率。

模型管理

遠端拉取模型清單

點擊 取得模型 按鈕，AQBot 會呼叫服務供應商的模型清單 API，自動拉取目前可用的全部模型。拉取後的模型會顯示在清單中供您選擇。

手動新增模型

如果服務供應商的模型清單 API 不完整或您需要新增特定模型，可以手動輸入模型 ID 進行新增。例如：

• gpt-4o
• claude-sonnet-4-20250514
• gemini-2.5-pro

模型參數

每個模型可以獨立設定以下預設參數：

自訂/本機端點

AQBot 支援連接任何相容 OpenAI API 格式的服務，以下是常見場景的設定範例。

Ollama

Ollama 可以在本機執行開源大模型。設定方法：

1. 新增服務供應商，類型選擇 OpenAI
2. Base URL 填寫 http://localhost:11434
3. API 金鑰留空或填寫任意值
4. 點擊 取得模型 拉取本機已下載的模型

vLLM / TGI

如果您使用 vLLM 或 Text Generation Inference 部署了自己的模型：

1. 新增服務供應商，類型選擇 OpenAI
2. Base URL 填寫您的部署位址，如 http://your-server:8000
3. API 金鑰根據您的服務設定填寫
4. 手動新增您部署的模型 ID

API 中繼服務

很多第三方提供 OpenAI 相容的 API 中繼服務，設定方法相同：

1. 新增服務供應商，類型選擇 OpenAI
2. Base URL 填寫中繼服務提供的位址
3. API 金鑰填寫中繼服務提供的金鑰
4. 取得或手動新增模型

預設模型設定

AQBot 支援為不同用途設定預設模型，在 設定 → 預設模型 中設定：

全域預設助手模型

新建對話時自動使用的模型。建議選擇您最常用的模型，例如 gpt-4o 或 claude-sonnet-4-20250514。

預設話題命名模型

用於自動為對話生成標題的模型。這個模型不需要很強大，選擇一個回應快且便宜的模型即可，如 gpt-4o-mini 或 gemini-2.0-flash。