配置服务商 | AQBot 文档

AQBot 支持接入多种 AI 服务商，你可以同时配置多个服务商并在对话中自由切换。

支持的服务商

AQBot 内置以下服务商类型，并支持任何兼容 OpenAI API 格式的自定义端点：

服务商	代表模型	说明
OpenAI	GPT-4o、GPT-4、o3、o4-mini	最广泛支持的 API 格式
Anthropic	Claude 4 Sonnet/Opus、Claude 3.5 Sonnet	原生 Claude API
Google	Gemini 2.5 Pro/Flash、Gemini 2.0	Google AI Studio 或 Vertex
DeepSeek	DeepSeek-V3、DeepSeek-R1	高性价比推理模型
阿里云通义千问	Qwen-Max、Qwen-Plus、Qwen-Turbo	兼容 OpenAI 格式
智谱 GLM	GLM-4、GLM-4-Flash	国产大模型
xAI	Grok-3、Grok-3-mini	xAI 出品
AWS Bedrock	Claude、Amazon Nova、Meta Llama 等	AWS 托管的统一对话接口
OpenAI 兼容	任意模型	适配所有兼容 OpenAI 格式的第三方服务

添加服务商

基本步骤

进入 设置 → 服务商
点击左下角的 + 按钮
填写以下信息：
- 名称 — 自定义名称，用于在界面中区分不同服务商
- 类型 — 选择对应的服务商类型（如 OpenAI、Anthropic 等）
- 图标 — 可选，为服务商选择一个显示图标
点击确认创建

AWS Bedrock

进入 设置 → 服务商，新增服务商并选择 AWS Bedrock。
填写 Bedrock 所在的 AWS Region，例如 us-east-1。AQBot 只使用该 Region 的 AWS 官方端点，不支持自定义 Endpoint URL。
在 AWS 凭据中填写 Access Key ID、Secret Access Key；临时凭据还需要填写可选的 Session Token。
点击 同步模型，获取当前 Region 内生命周期有效、支持文本输出和流式响应的基础模型。

IAM 身份至少需要以下权限：

text

bedrock:ListFoundationModels
bedrock:InvokeModel
bedrock:InvokeModelWithResponseStream

还需要在 AWS 控制台中为账号和 Region 开通对应模型的访问权限。凭据验证会调用 ListFoundationModels；因此 AccessDenied 也可能表示凭据本身有效，但缺少模型列表权限。

AWS 的模型发现接口不会返回所有可调用标识。使用跨 Region / application inference profile、Provisioned Throughput 或其他模型 ARN 时，请点击 添加模型，保持模型类型为对话，手工填写 inference profile ID 或 ARN。

AQBot 通过 Bedrock Converse / ConverseStream 支持文本、Base64 图片、多轮对话、工具调用和 Token 用量。首版不读取 AWS 默认凭据链，也不支持 Bedrock Embedding、Rerank、图像生成、远程图片 URL、extra_body 或扩展思考签名持久化。

参考 AWS 官方文档：Converse、模型发现。

配置 API

创建服务商后，需要填写 API 连接信息：

API 密钥

填入从服务商处获取的 API Key。例如 OpenAI 的密钥格式为 sk-...。

Base URL

API 的基础地址。各服务商的官方地址：

服务商	官方 Base URL
OpenAI	`https://api.openai.com`
Anthropic	`https://api.anthropic.com`
Google	`https://generativelanguage.googleapis.com`
DeepSeek	`https://api.deepseek.com`
阿里云通义	`https://dashscope.aliyuncs.com/compatible-mode`
智谱 GLM	`https://open.bigmodel.cn`
xAI	`https://api.x.ai`

如果你使用第三方中转服务或自建代理，将 Base URL 替换为中转地址即可。

API 路径

API 请求的路径部分，默认为 /v1/chat/completions。一般情况下无需修改，除非服务商使用了非标准路径。

从网页链接导入服务商

服务商官网、中转服务后台、私有模型平台或本地网关页面，可以提供一个 在 AQBot 中打开 的链接。用户点击后，浏览器会拉起 AQBot 桌面端，AQBot 会进入 设置 → 服务商，弹出确认框，并在用户确认后导入服务商配置。

用户使用流程

安装并打开支持服务商链接导入的 AQBot 版本。
在浏览器中点击服务商页面提供的 在 AQBot 中打开 链接。
在 AQBot 确认框中检查服务商名称、Base URL、服务商类型和 API Key 前缀。
点击确认后，AQBot 会按 Base URL + 类型 复用已有服务商；如果不存在则新建服务商，并在密钥不存在时追加 API Key。

AQBot 不会自动验证 API Key，也不会自动同步模型列表。导入后你可以点击 获取模型，或手动添加模型 ID。

链接格式

text

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

示例：

text

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

参数说明

参数	必填	说明
`name`	是	服务商显示名称，例如 `OpenAI`、`我的中转服务`
`baseurl`	是	服务商 Base URL，需要 URL 编码；仅允许 `http` / `https`，不允许 query 或 hash
`apikey`	是	要保存到 AQBot 的 API Key；确认框只展示前缀，不展示完整密钥
`type`	是	服务商类型；可选值：`openai`、`openai_responses`、`anthropic`、`gemini`、`custom`

baseurl 支持 AQBot 既有的强制后缀语义，例如 https://example.com!。通过链接导入时不会设置 api_path，AQBot 会继续按所选服务商类型使用默认路径逻辑。

官网/后台页面如何配置链接

对所有动态值使用 encodeURIComponent 或 URLSearchParams 进行编码：

html

<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

模型参数

每个模型可以独立配置以下默认参数：

参数	说明	典型范围
温度 (Temperature)	控制输出的随机性，值越高越有创意	0 – 2
最大 Token (Max Tokens)	限制单次回复的最大长度	1 – 模型上限
Top-P	核采样概率阈值，与温度配合使用	0 – 1
频率惩罚 (Frequency Penalty)	降低已出现词汇的重复概率	-2 – 2
存在惩罚 (Presence Penalty)	鼓励模型讨论新话题	-2 – 2

自定义/本地端点

AQBot 支持连接任何兼容 OpenAI API 格式的服务，以下是常见场景的配置示例。

Ollama

Ollama 可以在本地运行开源大模型。配置方法：

添加服务商，类型选择 OpenAI
Base URL 填写 http://localhost:11434
API Key 留空或填写任意值
点击 获取模型 拉取本地已下载的模型

vLLM / TGI

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

添加服务商，类型选择 OpenAI
Base URL 填写你的部署地址，如 http://your-server:8000
API Key 根据你的服务配置填写
手动添加你部署的模型 ID

API 中转服务

很多第三方提供 OpenAI 兼容的 API 中转服务，配置方法相同：

添加服务商，类型选择 OpenAI
Base URL 填写中转服务提供的地址
API Key 填写中转服务提供的密钥
获取或手动添加模型

New API

New API 是自托管网关，没有官方公网 Base URL。AQBot 已将其列为内置服务商：

打开 设置 → 服务商，选择 New API
填写你的实例根地址（例如 http://127.0.0.1:3000），不要粘贴 /v1/chat/completions 这类完整路径
添加 New API 管理后台颁发的令牌
点击 同步模型，勾选需要的模型后启用该服务商

默认端点格式为 OpenAI。New API 会把多数上游模型转换成 OpenAI 兼容请求。若要走 Claude 或 Gemini 原生协议，可在服务商编辑里改 端点格式。

默认模型设置

AQBot 支持为不同用途设置默认模型，在 设置 → 默认模型 中配置：

全局默认助手模型

新建对话时自动使用的模型。建议选择你最常用的模型，例如 gpt-4o 或 claude-sonnet-4-20250514。

默认话题命名模型

用于自动为对话生成标题的模型。这个模型不需要很强大，选择一个响应快且便宜的模型即可，如 gpt-4o-mini 或 gemini-2.0-flash。