aimod-cc/Agent2API

解决的问题

Agent2API 将多个 AI 桌面客户端的登录会话转换为一个本地 OpenAI 兼容的 API 网关。无需支付额外的 API Key 费用，您可以通过一个标准的端点复用您在 AI 桌面应用（如 WorkBuddy, Trae, Qoder 等）中已有的模型配额。任何支持自定义 base_url 的客户端都可以指向 http://127.0.0.1:3065/v1 并开始调用这些账号的模型，无需上游 API Key，也无需修改客户端。

工作原理

您只需安装 Agent2API（作为桌面托盘应用或通过 Docker）。首次运行时，它会在 3065 端口启动本地网关并打开管理面板。您可以通过面板添加 AI 桌面账号，通过网页登录、手机验证、粘贴凭据或导入本地会话数据（取决于提供商）进行配置。网关随后会以这些账号身份进行认证，将请求转发至官方上游服务，并将所有内容暴露为统一的 OpenAI 兼容 API（/v1/chat/completions, /v1/responses, /v1/messages, /v1/models）。它处理自动令牌刷新，在遇到速率限制 (429) 时在多个账号间轮询，应用按账号的代理设置，并报告请求统计信息。安全性通过可选的网关密钥（默认拒绝）和登录时的人工验证来强制执行。Docker 版本通过 Web 面板提供相同功能，并可在纯无头模式下运行。

适用人群

适合已经订阅了 AI 桌面客户端，并希望通过编程方式调用这些订阅而无需购买额外 API 额度的用户。也适合希望在多个提供商之间使用统一接口，或希望学习反向代理和多提供商协议适配的开发者。请注意，README 明确指出此项目仅供个人学习和研究使用，不得用于商业用途、转售或绕过计费。

核心亮点

• 开箱即用的 OpenAI 兼容性 — 支持 Chat, Responses 和 Messages 端点；只需设置 base_url 和任意虚拟 API Key。
• 17 个内置提供商 — 包括 WorkBuddy, 小浣熊 (Raccoon), CatPaw, Qoder, Trae 等；同时也支持自定义提供商。
• 自动凭据更新 — 令牌自动刷新，并支持对过期凭据进行批量刷新。
• 多账号轮询 — 请求按优先级排队，在 429 时切换账号，并遵守冷却时间。
• 按账号出站代理 — 每个账号可以拥有独立的出口 IP，网关会对出站流量进行指纹处理以模拟官方客户端。
• 全面报表 — 请求计数、成功率、令牌消耗、缓存命中率以及 365 天热力图。
• 定时任务 — 可从一个页面管理自动签到、凭据维护和模型列表刷新。
• 余额与使用量追踪 — 在线查看各账号余额和使用情况，支持跨账号并发查询。
• 两种部署模式 — 桌面托盘应用（无需 Node）和 Docker 容器，面板和网关使用相同端口，UI 支持六种语言。