Agent2API / 报表

报表

请求统计。时间范围只影响概览、缓存四窗口与按天 Token 趋势;热力图固定近 365 天、缓存趋势固定近 24 小时。本页按「定时任务」页设置的间隔自动刷新(默认 1 秒,仅在本页可见时请求)。

统计概览

近 7 天
正在加载…

活跃热力图

近 365 天,按天 Token 用量着色(档位按本窗口峰值自动定)
正在加载…
Token
方格为本地自然日,无请求显示为空槽

缓存命中率

正在加载…

近 24 小时缓存命中率趋势

按本地整点,无请求的整点不标注
正在加载…
缓存命中率左轴 总 Token右轴
无请求的整点按 0% 计,但不写读数

按天 Token 趋势

正在加载…

账号

所有提供商的账号排在同一条队列里:转发时从队首往下试,跳过已禁用、不支持该模型、或该模型正在限流的账号。

模型管理

内置提供商的模型管理:原始模型 ID 作为默认绑定,与新增别名一起在「模型映射」列独立开关。关闭某个名称后,下游不能用它请求,模型列表也不再返回它。

模型管理

上游模型倍率来源模型映射(原始 ID 与别名独立开关)操作
暂无模型
「默认」绑定就是原始模型 ID,只可开关、不可删除。原始 ID 与每个别名独立生效:关闭的名称不出现在 /v1/models,下游请求返回 404;其他开启的名称不受影响。

网关 Key

可创建多把 Key 分发给不同客户端,任一启用的 Key 即可通过鉴权;一把启用的都没有时不鉴权(仅监听 127.0.0.1,建议本机使用可不设)。

API Key 列表

未启用鉴权
名称Key创建时间启用操作
还没有 Key
客户端请求需带 Authorization: Bearer <key>x-api-key: <key>;修改后立即生效,本程序自身会自动使用第一把启用的 Key。每把 Key 可单独限制可用提供商可用模型(行内「可用范围」):留空 = 不限制,两个都设时按交集生效 —— 被限制的模型对这把 Key 表现为「不存在」(拉 /v1/models 也看不到它),提供它的家不在可用列表里时请求同样被拒。

文档

接入客户端需要的地址与协议。这里列出的地址随网关实际监听端口实时刷新,复制后直接粘进客户端的对应输入框即可。

接口地址

Base URL 填进客户端的「API 地址 / Base URL」
对话协议(按客户端支持的类型选一行)
OpenAI Chat Completions 多数 OpenAI 兼容客户端的默认协议
OpenAI Responses OpenAI 新协议(Codex、新版 SDK)
Anthropic Messages Claude Code / Anthropic SDK(token 计数:/v1/messages/count_tokens)
模型清单
模型列表 客户端自动拉取可用模型;不受鉴权限制,配 Key 之前就能拉
鉴权用「网关 Key」页里任一启用的 Key:请求带 Authorization: Bearer <key>x-api-key: <key>。一把启用的 Key 都没有时不鉴权(网关只监听 127.0.0.1)。

运行日志

记录登录、token 刷新、账号增删改、凭证维护、模型目录刷新、账号被标记限额(429)、自动签到、软件更新等系统事件;网关每次转发到上游的请求(含每次重试与敏感词命中)见「请求日志」页。本页的自动刷新间隔在「定时任务」页设置。

系统事件

正在加载日志…
日志保存在 ~/.agent2api/logs.jsonl,保留最近 500 条,重启后仍可查询。 429 自动切换会带上「原账号 → 目标账号」
第 1 / 1 页

定时任务

网关在后台定期自动执行的任务。可以在这里开关、调整执行间隔,或立即执行一次。关掉某个任务只影响它自己的自动执行,不影响你在别处手动操作。

任务清单

状态每 20 秒自动同步
正在加载定时任务…
任务配置保存在 ~/.agent2api/config.jsonscheduledTasks 字段 改动立即生效,不需要重启程序

请求日志

网关每次转发到上游的模型请求:提供商与账号、重试、状态码、模型、用时与 Token 用量,按时间倒序。可按时间、状态、提供商、模型四个维度筛选(后两个的选项是这份日志里实际出现过的值)。悬停「重试」列的标签可看每次尝试的账号、失败原因与重试明细;开启调试模式后「详情」列可查看完整的上游原始报文。本页的自动刷新间隔在「定时任务」页设置。

请求日志列表

按时间倒序,保留期在设置页可调
正在加载请求日志…
上报的是网关报文里的模型名,别名 / 映射后的名字按上游收到的那次记录 账号为空表示请求在选定账号之前就失败了
第 1 / 1 页

设置

桌面端的启动与托盘行为、账号数据的导入 / 导出,以及软件更新与数据保留天数。这些设置保存在本机,重启后依然生效。定时任务(自动签到、凭证维护、页面自动刷新等)在「定时任务」页。

启动与托盘

检测中…

计量单位

请求超时

检测中…
建立上游 TCP/TLS 连接或代理隧道的最大等待时间(秒),默认 30 秒,范围 1~3600。
请求发出后等待上游响应头的最大时间(秒),默认 300 秒,范围 1~3600。
流式响应相邻数据之间允许的最大空闲时间(秒),收到新数据后重新计时,默认 300 秒,范围 1~3600。
读取完整非流式响应体允许的最大时间(秒),默认 300 秒,范围 1~3600。
保存后立即生效,不用重启;超时按上游失败处理(计入请求日志的「错误」列,并按「请求重试」的设置决定是否重试)。

请求重试

检测中…
在同一个账号上原地重发几次(不含首发;整条请求共用一份,用完后换来的账号只发一次就继续换)。可填 0–10,0 表示失败立即换号。
失败后最多再换几个账号试(填 N = 最多换 N 个,首发那个不算)。换到同一家名下另一个账号、或换到另一家,都各算一次;换满仍失败就返回错误。可填 0–10,0 表示失败立即报错。
两次重试之间的等待时间,两项共用,可填 0–300 秒。
命中这些上游状态码的失败不再重试(同一账号不重发、也不换账号,错误原样返回给客户端)。输入 100–599 的状态码后回车添加,点 × 或退格删除;默认 402(积分不足)。清空全部表示任何错误都照常重试。
保存后立即生效,不用重启;次数用尽仍失败时,错误原样返回给客户端。

调试模式

检测中…
开启后新发生的请求才会被记录(已经过去的请求补不回来)。报文单独存放,位置可在左侧「数据 → 保存位置」里更改。

指纹脱敏

检测中…
默认开启。命中明细会记进请求日志的「敏」标签(悬停可看命中了哪几条规则)。本项只改发给上游的副本,客户端看到的响应内容不变。

系统提示词

检测中…
替换 = 客户端 system / developer 消息全部删掉,换成网关的提示词;追加 = 保留客户端内容,只在开头 system 块之后多插一条。两者都只改发给上游的副本,客户端看到的响应不变。
UTF-8 文本文件路径,留空用内置默认提示词(通用编码助手提示词,不含任何会被上游拦截的模板句)。只在「替换 / 追加」模式下生效,透传模式不读它。
改完立即生效,不用重启(下一个请求就用新模式)。降级是自动的临时状态,解除后本模式自己的提示词立刻恢复。

账号导入 / 导出

导出文件内含 accessToken / refreshToken / apiKey 等凭证与自定义提供商定义,可直接用于登录。请妥善保管,不要外传或上传到公共位置。

机器人校验

开启后,登录页在浏览器后台自动完成验证(对真人无感),而脚本每次尝试都要先算一道题 —— 暴力破解与抢注的成本显著上升。仅影响面板的登录 / 注册,与 API 客户端的 API Key 无关。

数据保留

检测中…
登录 / 账号切换 / 429 切换等系统事件,可填 1–3650 天。
「请求日志」页的逐条请求记录,可填 1–3650 天。
报表页的热力图与按天趋势,可填 1–3650 天。
保存后立即生效:改小保留天数会立刻删除超出的历史数据,且不可恢复。

数据存储

检测中…
配置目录下的 agent2api.db(账号、日志、请求记录、调试报文与设置都在里面)。
库主文件的大小(不含运行期间的 WAL 临时文件,退出时已自动并回)。
账号
事件日志
请求记录
报表天数
调试报文
数据统一保存在配置目录下的 agent2api.db;如需更换位置,请设置环境变量 AGENT2API_PROXY_HOME 后重启程序。

软件更新

未检查
更新源
当前版本 最新版本
点击「检查更新」查询最新发布版本。
更新日志