你的 Agnes AI API 不是坏了,是"搬家"了
7 月 29 日,Agnes AI 悄悄把国内入口从
.com换到了.cn。模型没下架,免费没取消,Key 也不用换——你只需要改一个地址。
先说结论
如果你这几天发现platform.agnes-ai.com打不开、代码里的 API 调用开始报超时或 401,别慌,不是平台跑路了。
Agnes AI 在2026 年 7 月 29 日做了一次国内入口迁移:
| 项目 | 旧地址(国际站) | 新地址(国内节点) |
|---|---|---|
| 控制台 / 平台网页 | platform.agnes-ai.com | platform.agnes-ai.cn |
| API 调用 Endpoint | apihub.agnes-ai.com/v1 | apihub.agnes-ai.cn/v1 |
你的 API Key 继续有效,不需要重新注册。官方通稿原话是:“只需将接口地址从国际站域名替换为国内站域名即可。”
到底发生了什么
把时间线拉出来看就很清楚:
- 6 月 1 日:Agnes 宣布文本 / 图像 / 视频全模态 API无限期免费,无需绑卡。免费首周,文本模型调用量就突破了1 万亿 Token,图像生成超 200 万张。
- 7 月 29 日:Agnes 正式启用国内官网
agnes-ai.cn,API 入口同步切换到国内节点。同一天,官方还公布了新模型Agnes-2.5-Pro Alpha在 Artificial Analysis 榜单上拿到39 分、第 9 名(共 153 个参评模型)的成绩。 - 7 月 30 日:凤凰网、网易、搜狐、太平洋科技等多家媒体集中报道了这次迁移。
所以你的体感——“前几天还正常,这两天突然不行”——完全对得上。旧.com入口走的是跨境链路,本来就不太稳定;换挡之后官方把保障重心移到了.cn节点,旧入口对国内用户的连通性就进一步下降了。
官方为什么做这个决定
翻遍所有通稿,官方给出的理由很朴素,核心就一句话:
“为给国内用户提供更优质稳定的服务。”
另一句是:
“此次国内官网上线,是其进一步完善国内用户服务体系的重要一步。”
没有更多了。官方没有展开讲技术细节或合规考量,就是"让国内用户用得更稳"。
但如果把上下文串起来,这个时间点其实不难理解:
第一,用量爆了,稳定性从"锦上添花"变成了"刚需"。6 月免费之后,国内开发者蜂拥而入,首周 1 万亿 Token 的调用量摆在那里。创始人 Bruce Yang 说过一句话:“我们想让多模态 AI 能力像水和电一样成为基础设施,而非少数人的特权。” 既然是"水和电",那供水管道就不能还是一条抖抖索索的跨境线路。
第二,这是一次"能力 + 入口"的组合拳。同一天发布 2.5 系列的榜单成绩(39 分 / 第 9 名),同一天宣布 2.5 Flash 继续不限期免费,同一天切换国内节点——三件事放在一起,意图很明确:在国内开发者心里,把 Agnes 从"一个能白嫖的海外接口"升级成"一个长期可用的主力选项"。
第三,从行业惯例看,这一步迟早要走。跨国 SaaS 服务进入国内市场,启用.cn域名 + 本地节点几乎是标准操作——就近接入降延迟、链路更可控、也为后续的合规备案做准备。这不是 Agnes 独有的选择,而是所有想做中国市场的海外 AI 服务都会走的路。
怎么修:三步搞定
第一步:控制台换域名
浏览器打开platform.agnes-ai.cn,用原来的账号登录,确认 Key 还在、模型列表正常(如果无法登录,需要重新注册)。
第二步:代码里换 base_url
把 host 从.com改成.cn,路径/v1不动。先用 curl 验证一下:
curlhttps://apihub.agnes-ai.cn/v1/chat/completions\-H"Authorization: Bearer 你的Key"\-H"Content-Type: application/json"\-d'{"model":"Agnes-2.5-Flash","messages":[{"role":"user","content":"ping"}]}'Python(OpenAI 兼容 SDK):
fromopenaiimportOpenAI client=OpenAI(api_key="你的Key",# 不用换base_url="https://apihub.agnes-ai.cn/v1"# 只改这里)resp=client.chat.completions.create(model="Agnes-2.5-Flash",messages=[{"role":"user","content":"ping"}])print(resp.choices[0].message.content)第三步:检查/v1有没有拼重
这个坑跟 Agnes 无关,是客户端拼接规则的差异,但接入时一定会遇到:
- OpenAI 官方 SDK:
base_url里要带/v1,SDK 只会在后面拼/chat/completions,不会重复加。 - 某些第三方工具(部分 Agent 框架、IDE 插件):会自动追加
/v1。这时候你的base_url就不能再带/v1,否则请求变成.../v1/v1/chat/completions,直接 404。
判断方法很简单:看报错里的请求路径,如果出现/v1/v1,去掉一个就行。
还是不行?按报错码查
| 报错 | 大概率原因 | 怎么修 |
|---|---|---|
| 连接超时 / DNS 解析失败 | base_url 的 host 还没换成.cn,或网络问题 | 换地址;换网络 / 清 DNS 缓存 |
| 401 Unauthorized | Key 复制不完整,或用了错误站点的 Key | 去.cn控制台重新复制 Key |
| 404 Not Found | /v1/v1双拼;或模型 id 已下线 | 检查路径;核对当前可用模型名 |
| 控制台网页打不开 | 还在访问.com旧地址 | 改成platform.agnes-ai.cn |
顺便确认:免费还在,能力还升了
这次换的只是入口,不是政策:
- Agnes-2.5-Pro Alpha:Artificial Analysis 综合榜单 39 分 / 第 9 名,强项是复杂编码与推理。
- Agnes-2.5-Flash:继续不限期免费。
- 6 月 1 日起的全模态免费政策(文本 / 图像 / 视频)没有变化。
入口换了,免费还在,模型还升级了。官方要的就是"无感迁移"——改个地址,其他一切照旧。
写在最后
回到最开始那个问题:“前几天还正常,怎么突然不能用了?”
答案很简单:它没坏,它搬家了。而且是为了离你更近才搬的。
对开发者来说,行动清单就三行:
- 控制台改登
platform.agnes-ai.cn - 代码
base_url把.com换成.cn - 检查
/v1别拼重
改完跑一次 ping,能回包,就说明你和这头"撸代码的 AI 怪兽"又重新连上了。
参考来源
- 凤凰网科技,2026-07-29:Agnes 国内 API 节点来了
- 网易新闻,2026-07-29:Agnes 国内 API 节点来了
- 搜狐,2026-07-30:Agnes 国内 API 节点来了,AI 编程解禁
- 搜狐,2026-07-30:AgnesAI 国内官网与 API 服务全新升级
- ITBEAR,2026-07-30:Agnes 国内 API 节点上线
- ITBEAR,2026-07-30:Agnes 国内官网及 API 服务焕新升级
- 太平洋科技,2026-07-30:Agnes 国内 API 节点来了
- 今日头条,2026-06-09:国产大模型 Agnes AI:全模态 API 无限期免费
- 爱分析,2026-06-09:免费开放一周后,我们调研了 Agnes AI 用户社区
- 百度百科:Agnes AI
文中 Mermaid 图为作者根据公开报道绘制,非官方截图。模型可用性与限流额度以控制台实时显示为准。