AgentRouter 公益 API 中转站:注册、国内镜像与 Codex 排错

AgentRouter 公益 API 中转站:注册、国内镜像与 Codex 排错
一线灵本文作者:奈奈
前言
AgentRouter 是一个公益性质的大模型 API 中转站,控制台和接口体系基于 New API / One API 一类架构,支持 OpenAI、Anthropic 等兼容协议。我主要拿它做个人编程、临时调试和学习测试,不把它当生产接口。
站内模型会随上游资源动态调整,目前常见的有 gpt-6-astra、Sol 系列等。具体模型名、倍率和可用状态,始终以控制台的模型列表与公告为准。
这是第三方公益中转服务,不提供稳定性承诺。不要上传隐私、密钥、商业源码等敏感数据,也不建议接入生产环境。
站点入口
注册与额度
| 项目 | 当前规则 |
|---|---|
| 登录方式 | 使用 GitHub 账号授权登录,无需绑定支付方式 |
| 新用户额度 | 通过邀请链接注册并完成首次签到,当前首日最高可得 $175 |
| 每日签到 | 退出账号后重新登录即可触发,官方当前公告为每天 $25 |
| 充值 | 公益站目前不支持常规充值,额度主要来自签到、邀请和官方活动 |
额度规则改动比较频繁,如果实际到账与本文不同,以控制台显示为准。
额度没有立即到账时,先退出账号再重新登录一次。每日签到也是同样的触发方式。
国内备用镜像登录
备用镜像有时没有独立处理 GitHub OAuth 回调。若你从备用镜像发起登录,授权完成后却被送回 agentrouter.org,可以手动替换回调地址中的域名。
GitHub OAuth 回调处理
- 从备用镜像发起登录
打开备用镜像邀请地址:
- 完成 GitHub 授权
点击 GitHub 登录并完成授权。授权成功后,浏览器可能跳回主站域名下的回调地址。
- 只替换域名
在地址栏中将回调 URL 的域名从:
1 | agentrouter.org |
改为:
1 | ps.air-outer.com |
保留后面的路径和查询参数不动,然后回车进入控制台。
只改域名,不要删除回调路径和参数,也不要把 GitHub 返回的授权信息复制到其他网站。
使用时要注意什么
- 公益站在高峰期可能限流或耗尽公共额度。遇到
402 Budget pool quota has been exhausted时,等待下一批额度、重试请求,或者临时切换其他模型。 - 模型上下线很快,配置前先去控制台确认模型 ID。名称写错或模型已下线时,通常会直接报
503。 - 日常代码编写、内容生成和学习测试基本够用,但稳定性看上游,不要把它当作唯一接口。
gpt-6-astra烧额度很快,而且供应策略会调整,长任务之前最好先看公告。
gpt-6-astra 适合关键任务,不适合无节制地跑长上下文。公益额度看起来很多,真正烧起来也很快。
编排工具与 probation 分组
AgentRouter 会识别客户端和使用场景。非编程用途、异常调用方式或未受支持的客户端,可能被放进 probation 分组,调用倍率会翻倍。官方说这个分组会动态更新,恢复一段时间的正常使用后可能移出。
建议优先使用官方列出的常见工具,例如 Claude Code、Codex、OpenCode、Cline、Roo Code、Hermes 等,并按对应文档配置,不要拿普通聊天软件硬接。
使用官方推荐工具也不能百分百避开 probation。Discord 里有人反馈使用 Codex CLI 仍被分组,我自己完全拿来编程也中过。申诉多天没有回复,所以最好提前准备一个备用中转。
我遇到的几个问题
1. Codex 报 Missing environment variable: CODEX_GATEWAY_API_KEY
按官方方式配置 Codex CLI 后,我一直遇到:
1 | Missing environment variable: CODEX_GATEWAY_API_KEY |
先确认 config.toml 中已经定义名为 AgentRouter 的 provider,并且 API Key 配置没有填错。我的实际解决办法是在启动时明确指定 provider:
1 | codex -c 'model_provider="AgentRouter"' |
直接运行 codex 不行,但加上这段参数后可以正常启动。
2. 被加入 probation 分组
我的使用场景一直是正常编程,但仍然进过 probation。我也尝试联系官方申诉,等了多天没有回应。
先停止异常并发和非编程请求,换回官方支持的客户端,正常使用一段时间观察是否自动移出。如果倍率长期不恢复,直接换备用中转更省事,没必要一直耗到封号。
3. 工具报 unauthorized client
如果你确实使用的是 Codex CLI,但请求经过代理或中间层后丢了 User-Agent,可以尝试补上:
1 | {"user-agent": "codex_cli_rs/0.166.0"} |
这只适合修复 Codex CLI 的兼容问题,不要拿它伪装其他未受支持的客户端。
最后
AgentRouter 的优点很直接:免费、注册方便、支持的编程工具多,还有国内备用镜像。缺点也同样明显:公共额度会波动,模型可能临时上下线,probation 的判定也不够透明。
我的定位是把它当个人开发和学习时的备用接口。能用就用,关键项目和敏感内容还是走官方 API 或稳定的付费服务。




