前言
这两年,AI Agent 发展得越来越快,各种各样的 AI Agent 客户端层出不穷,Trae、Qoder、Cline、WorkBuddy 等工具都值得体验。无论是编写代码、自动化办公,还是让 AI 帮我们执行各种复杂任务,Agent 都能带来不少效率提升。
不过,想要真正把这些 Agent 用起来,往往绕不开一个问题:API Key 太贵了!
很多主流模型的官方 API 都是按照 Token 用量计费的,尤其是在使用 AI Agent 执行多步骤任务时,模型调用次数多、上下文消耗大,费用很容易就上去了。对于个人开发者和喜欢折腾开源项目的玩家来说,长期承担这笔费用确实不太划算。
那么,有没有一种办法,能够低成本获取 API Key,让自己可以更加自由地体验各种 AI Agent 呢?
今天给大家分享一个非常有意思的开源项目——Agent2API。它的思路比较特别:不再局限于直接购买官方 API,而是将你已经登录的各种 AI Agent 客户端接入进来,把不同平台的模型调用额度统一转换成标准 API 接口。
项目支持接入 50 多种 Agent 客户端,提供 OpenAI、Anthropic 等兼容接口,还支持多账号管理、额度轮换、自动签到和用量统计。这样一来,原本分散在不同客户端中的免费试用额度和可用额度,就有机会通过统一接口进行调用。
对我来说,这个项目还有一个很实用的场景:我平时一直在使用 Hermes Agent,正好可以通过 Agent2API 提供的兼容接口,让 Hermes Agent 调用其他客户端中已经拥有的模型额度。
如果你也经常折腾 AI Agent,又不想为各种 API 费用买单,那么这个项目值得研究一下。
下面就带大家一起部署 Agent2API,看看它到底如何把不同客户端的模型额度整合成一个统一的 API 服务。
说明
这个项目我主要是给部署在VPS上的Hermes Agent使用,所以本项目部署在云服务上,接口公网访问,大家没有云服务器的可以本地部署MAC系统安装Docker/Windows系统部署Docker都可以docker部署本项目然后本地调用
项目图示
主界面-AI助手

报表统计

签到中心-支持定时签到

支持Agent账号

兼容其他API

插件中心

模型管理

agent配置

网关key

接口文档

项目简介
本地 AI 路由网关 + Agent 客户端接管:复用各家客户端登录态,一个 base_url 调用 50+ 家模型额度,统一 OpenAI / Anthropic / 生图接口,多账号选路、签到、余额与请求报表一体管理
✨ 核心特性
- 🔌 统一模型接口 —— 支持 OpenAI Chat / Responses / Images 与 Anthropic Messages 协议,以及统一的模型列表;小浣熊、Loomy、Antigravity、ModelScope、WorkBuddy、豆包工作 提供文生图,小浣熊、Loomy、Antigravity、ModelScope 与 WorkBuddy 还支持参考图编辑;生图与编辑也可由 AI 助手工具调用
- 🧭 AI 路由 —— 模型映射、账号优先级、负载均衡、会话粘性与失败切换集中配置
- 🤖 Agent 客户端接管 —— 管理本机客户端的多套连接配置,导入现有配置、预览写入内容并切换网关或自定义服务
- 🧩 插件扩展 —— 额外提供商实现独立安装和更新,不随主程序打包;自定义提供商无需插件
- 🛡️ 出网代理 —— 账号与更新任务可选择代理池中的出口
- 🔑 网关安全 —— 网关 Key 可分权、面板登录支持人机验证,未配置 Key 时默认拒绝模型请求
- 📊 请求报表 —— 请求量、成功率、Token 消耗、缓存命中率与 365 天热力图
- ⏰ 后台维护 —— 管理模型目录刷新、凭证维护与软件更新检查;每日签到按各家自己的窗口时刻执行(Qoder 10:01、ZCode 19:01,其余跟随条目时刻),另有一轮补签只处理当天还没签上的账号;额外提供商专属任务由插件扩展
- 🖥️ 三种形态 —— 桌面端(Windows / macOS / Linux,托盘常驻)、服务端(Windows / Linux,无界面)、Docker(amd64 / arm64);无需 Node 运行时,界面支持六种语言
部署方法
使用Docker安装
本教程使用docker的方式安装部署,简单便捷

X86/Arm双平台
| 平台 | 架构 | 适用场景 |
|---|---|---|
| linux/amd64 | x86_64 | VPS、PC服务器、Intel/AMD |
| linux/arm64 | ARM64 | 树莓派、Mac M系列、ARM 云服务器 |
准备条件
1)一台服务器
我们使用莱卡云VPS来演示,建议选择境外云服务器(免备案)
需要vps的可以看以下信息,配置尽量选择大点的比如1核心2G内存
莱卡云官网
2)本教程使用到的项目
本教程使用的官方github地址
https://github.com/aimod-cc/Agent2API

如果感觉有用,请帮忙给作者点个stars
也可以fork到自己的仓库让各种AI agent增加自己的个性化需要
3)域名(可选)
根据自己的需求
1.web界面建议绑定域名,方便使用
VPS部署
一、Docker环境部署
在vps安装docker和docker-compose
Docker官方安装文档(英文)
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档(英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose(中文)
https://duan.yyzq.eu.org//04
==推荐直接用一键脚本==
docker安装脚本
bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)
==这个脚本自带最新版的docker compose==
==用法是docker compose up -d少了-==
如果习惯用旧版本的docker-compose可以安装这个
docker-compose安装脚本
curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose
二、部署命令
登录我们自己的境外VPS使用root账户执行以下步骤
docker-compose命令
创建一个目录,并进入此目录
mkdir agent2api ;cd agent2api
请自行安装vim编辑器
然后再新建docker-compose.yml
vim docker-compose.yml
services:
agent2api:
image: aimodcc/agent2api:latest
container_name: agent2api
restart: always
ports:
- "3065:3065"
volumes:
- ./data:/data
注意端口如有冲突自行修改
三、执行容器运行命令
docker-compose up -d #运行容器
docker-compose ps #查看是否启动成功
==正常启动如下所示==
docker-compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
agent2api aimodcc/agent2api:latest "/usr/local/bin/agen…" agent2api 5 days ago Up 5 days (healthy) 0.0.0.0:3065->3065/tcp, [::]:3065->3065/tcp
四、web界面
打开web页面使用
成功以后需要打开自己相应的端口3065)防火墙就可以web端访问了
主界面
http://ip:3065
首次创建管理员账号密码

第一步先把插件按上

然后就可以添加账号了

然后新增一个api就可以给自己的 其他agent使用了

具体的模型的上下文等信息可以查看这里

这是接口地址

如果自己有域名最好给绑定下域名
绑定域名
接下来就是绑定域名和配置SSL证书
NginxProxyManager项目
绑定域名可以参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch
其他功能自行探索即可
或者fork整个项目到自己的仓库让AI给你增加个性化的需求
==有任何问题可以直接留言或者问我==
==有任何问题可以直接留言或者问我==
==有任何问题可以直接留言或者问我==
欢迎关注我们的微信公众号!

评论区