目 录CONTENT

文章目录

API Key 太贵?开源 Agent2API 来了!整合 50+ AI Agent 客户端额度,Hermes Agent 也能用!

Administrator
2026-11-22 / 0 评论 / 0 点赞 / 19 阅读 / 0 字

前言

这两年,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助手
001-xaPo.png

报表统计
002-awBE.png

签到中心-支持定时签到
003-DzSe.png

支持Agent账号
004-sOgo.png

兼容其他API
005-NlSd.png

插件中心
006-vgTw.png

模型管理
007-Srgv.png

agent配置
008-snJz.png

网关key
009-yuSu.png

接口文档
010-hyAg.png

项目简介

本地 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的方式安装部署,简单便捷
011-KCVR.jpeg

X86/Arm双平台

平台架构适用场景
linux/amd64x86_64VPS、PC服务器、Intel/AMD
linux/arm64ARM64树莓派、Mac M系列、ARM 云服务器

准备条件

1)一台服务器

我们使用莱卡云VPS来演示,建议选择境外云服务器(免备案)
需要vps的可以看以下信息,配置尽量选择大点的比如1核心2G内存
莱卡云官网

2)本教程使用到的项目

本教程使用的官方github地址
https://github.com/aimod-cc/Agent2API
012-VJCz.png

如果感觉有用,请帮忙给作者点个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

首次创建管理员账号密码
013-EYVm.png

第一步先把插件按上
014-hFMx.png

然后就可以添加账号了
015-cMsJ.png

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

具体的模型的上下文等信息可以查看这里
017-SDVb.png

这是接口地址
018-ixuq.png

如果自己有域名最好给绑定下域名

绑定域名

接下来就是绑定域名和配置SSL证书

NginxProxyManager项目

绑定域名可以参考
NginxProxyManager
https://duan.yyzq.eu.org//npm-ch

其他功能自行探索即可
或者fork整个项目到自己的仓库让AI给你增加个性化的需求

==有任何问题可以直接留言或者问我==
==有任何问题可以直接留言或者问我==
==有任何问题可以直接留言或者问我==

欢迎关注我们的微信公众号!
微信公众号

0
  1. 支付宝打赏

    qrcode alipay
  2. 微信打赏

    qrcode weixin
  3. QQ打赏

    qrcode qq

评论区