New APINew API
使用指南部署安装API 参考AI 应用Skills帮助支持商务合作合规与使用政策
⚠️合规提示:本项目仅用于合法授权的 API 网关、内部管理和私有化部署场景。请遵守上游服务条款、平台规则、监管要求和内容安全要求。

AQBot - 本地优先的桌面 AI 工作台

AQBot 教程 — 将本地优先桌面 AI 工作台对接 New API。支持 aqbot:// 一键导入,以及 OpenAI / Claude / Gemini 协议手动配置。

聊天设置选项

在 New API 控制台的系统设置->聊天设置中,可添加如下快捷选项,便于在令牌管理页一键填充到 AQBot:

{ "AQBot": "aqbot://providers?name=New%20API&baseurl={address}&apikey={key}&type=openai" }

AQBot 是一款本地优先的开源桌面 AI 工作台(AGPL-3.0),统一多服务商对话、ACP Agent、知识库、MCP 工具与本地 API 网关,应用数据与用户文件保留在本机。

AQBot

核心特性

  • 多服务商对话 — 连接 OpenAI、Claude、Gemini、DeepSeek、Qwen 以及任意 OpenAI 兼容端点
  • 服务商快速导入 — 通过 aqbot:// 链接导入服务商,确认后写入本地配置
  • 模型管理 — 同步远程模型列表、能力标签与延迟测试
  • Agent — 对话内 Agent(使用已配置服务商 API)与 ACP Agent 工作台
  • 本地数据 — 应用状态位于 ~/.aqbot/,用户文件位于 ~/Documents/aqbot/

完整功能请参考 AQBot 官网。本页只覆盖对接 New API。

NewAPI 接入方法

请使用您自己部署的 New API,或确认服务方具备合法上游授权和合规义务的 New API 服务。不要将来源不明的 API 地址或密钥接入生产环境。

方式一:一键导入(推荐)

  1. 安装并至少打开过一次 AQBot 桌面端,系统才会注册 aqbot:// 协议
  2. 在 New API 控制台的「系统设置 → 聊天设置」中加入上文 JSON
  3. 打开「令牌管理」,在目标令牌的操作菜单中选择 AQBot
  4. 浏览器唤起 AQBot,在确认框中核对服务商名称、API 地址、类型 openai 和密钥前缀
  5. 确认后 AQBot 会进入 设置 → 服务商管理;按 API 地址 + 类型复用已有服务商,否则新建
  6. 打开该服务商,点击 同步模型,再回到对话页选择模型开始使用

{address} 是 New API 站点根地址(例如 https://your-newapi.example),不要带 query。AQBot 对 OpenAI 类型会自动补上 /v1。导入后不会自动验证密钥,也不会自动同步模型。

方式二:手动配置

  1. 在 New API 令牌管理页复制 API Key
  2. 打开 AQBot → 设置 → 服务商管理添加服务商
  3. 填写以下字段:
字段填法
服务商名称例如 New API
服务商类型OpenAI(推荐)
API 地址New API 站点地址,如 https://your-newapi.example
API 密钥New API 令牌
  1. 点击 同步模型,拉取 New API 当前可用的模型
  2. 回到对话页,选择刚同步的模型开始使用

切换模型

API 地址注意

  • 推荐只填站点根地址,让 AQBot 自动补 /v1
  • 如果地址已经以 /v1 结尾,AQBot 不会再追加
  • 只有在必须禁用自动补全时,才在地址末尾加 !

可选:原生协议

New API 同时提供 Claude / Gemini 原生接口时,可以再添加一条服务商:

需求服务商类型API 地址
Chat Completions(默认)OpenAI站点根地址
Claude 原生 /v1/messagesAnthropic站点根地址
Gemini 原生Gemini站点根地址

一键导入模板里的 type 对应改为 anthropicgemini。同一套 API Key 可以挂多条服务商。

常见问题

  • 点击 AQBot 没有唤起应用:先安装并启动过桌面端。只打开官网或开发服务器不会注册 aqbot://
  • 导入成功但无法对话:先点击「同步模型」,并确认模型 ID 与 New API 实际暴露的名称一致
  • macOS 提示「已损坏」或「无法验证开发者」:按 AQBot README官方快速开始放行当前应用,不必关闭整个 Gatekeeper
  • 一键链接里带有 API Key:只在已登录的令牌页生成该链接,不要把带真实密钥的 URL 发到公开页面

相关链接

这篇文档对您有帮助吗?

最后更新于