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

本文作者:奈奈

前言

AgentRouter 是一个公益性质的大模型 API 中转站,控制台和接口体系基于 New API / One API 一类架构,支持 OpenAI、Anthropic 等兼容协议。我主要拿它做个人编程、临时调试和学习测试,不把它当生产接口。

站内模型会随上游资源动态调整,目前常见的有 gpt-6-astra、Sol 系列等。具体模型名、倍率和可用状态,始终以控制台的模型列表与公告为准。

这是第三方公益中转服务,不提供稳定性承诺。不要上传隐私、密钥、商业源码等敏感数据,也不建议接入生产环境。

站点入口

注册与额度

项目 当前规则
登录方式 使用 GitHub 账号授权登录,无需绑定支付方式
新用户额度 通过邀请链接注册并完成首次签到,当前首日最高可得 $175
每日签到 退出账号后重新登录即可触发,官方当前公告为每天 $25
充值 公益站目前不支持常规充值,额度主要来自签到、邀请和官方活动
使用邀请链接注册

额度规则改动比较频繁,如果实际到账与本文不同,以控制台显示为准。

额度没有立即到账时,先退出账号再重新登录一次。每日签到也是同样的触发方式。

国内备用镜像登录

备用镜像有时没有独立处理 GitHub OAuth 回调。若你从备用镜像发起登录,授权完成后却被送回 agentrouter.org,可以手动替换回调地址中的域名。

GitHub OAuth 回调处理

  1. 完成 GitHub 授权

点击 GitHub 登录并完成授权。授权成功后,浏览器可能跳回主站域名下的回调地址。

  1. 只替换域名

在地址栏中将回调 URL 的域名从:

1
agentrouter.org

改为:

1
ps.air-outer.com

保留后面的路径和查询参数不动,然后回车进入控制台。

只改域名,不要删除回调路径和参数,也不要把 GitHub 返回的授权信息复制到其他网站。

使用时要注意什么

  1. 公益站在高峰期可能限流或耗尽公共额度。遇到 402 Budget pool quota has been exhausted 时,等待下一批额度、重试请求,或者临时切换其他模型。
  2. 模型上下线很快,配置前先去控制台确认模型 ID。名称写错或模型已下线时,通常会直接报 503。
  3. 日常代码编写、内容生成和学习测试基本够用,但稳定性看上游,不要把它当作唯一接口。
  4. 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 或稳定的付费服务。


转载至:https://my.feishu.cn/wiki/UfKLwy4ZLijXRwkaYGvcjEb3nQg