news 2026/8/1 21:47:40

你的 Agnes AI API 不是坏了,是“搬家“了

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
你的 Agnes AI API 不是坏了,是“搬家“了

你的 Agnes AI API 不是坏了,是"搬家"了

7 月 29 日,Agnes AI 悄悄把国内入口从.com换到了.cn。模型没下架,免费没取消,Key 也不用换——你只需要改一个地址。


先说结论

如果你这几天发现platform.agnes-ai.com打不开、代码里的 API 调用开始报超时或 401,别慌,不是平台跑路了

Agnes AI 在2026 年 7 月 29 日做了一次国内入口迁移:

项目旧地址(国际站)新地址(国内节点)
控制台 / 平台网页platform.agnes-ai.complatform.agnes-ai.cn
API 调用 Endpointapihub.agnes-ai.com/v1apihub.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 官方 SDKbase_url要带/v1,SDK 只会在后面拼/chat/completions,不会重复加。
  • 某些第三方工具(部分 Agent 框架、IDE 插件):会自动追加/v1。这时候你的base_url不能再带/v1,否则请求变成.../v1/v1/chat/completions,直接 404。

判断方法很简单:看报错里的请求路径,如果出现/v1/v1,去掉一个就行。

不会(如 OpenAI SDK)

会(部分第三方工具)

配置 base_url

你的客户端会自动加 /v1 吗?

base_url 带 /v1 ✅

base_url 不带 /v1 ✅

最终路径:.../v1/chat/completions ✅


还是不行?按报错码查

报错大概率原因怎么修
连接超时 / DNS 解析失败base_url 的 host 还没换成.cn,或网络问题换地址;换网络 / 清 DNS 缓存
401 UnauthorizedKey 复制不完整,或用了错误站点的 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 日起的全模态免费政策(文本 / 图像 / 视频)没有变化。

入口换了,免费还在,模型还升级了。官方要的就是"无感迁移"——改个地址,其他一切照旧。


写在最后

回到最开始那个问题:“前几天还正常,怎么突然不能用了?”

答案很简单:它没坏,它搬家了。而且是为了离你更近才搬的。

对开发者来说,行动清单就三行:

  1. 控制台改登platform.agnes-ai.cn
  2. 代码base_url.com换成.cn
  3. 检查/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 图为作者根据公开报道绘制,非官方截图。模型可用性与限流额度以控制台实时显示为准。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/1 21:47:03

LSD目标检测模块深度剖析:从PointPillar到RTM3D的实时推理方案

LSD目标检测模块深度剖析:从PointPillar到RTM3D的实时推理方案 【免费下载链接】lidar-slam-detection LSD (LiDAR SLAM & Detection) is an open source perception architecture for autonomous vehicle/robotic 项目地址: https://gitcode.com/gh_mirrors/…

作者头像 李华
网站建设 2026/8/1 21:46:51

Muya性能优化指南:提升大型文档编辑体验的7个技巧

Muya性能优化指南:提升大型文档编辑体验的7个技巧 【免费下载链接】muya 📄 Future markdown editor for web browser applications development 项目地址: https://gitcode.com/gh_mirrors/mu/muya Muya作为一款面向Web应用开发的未来Markdown编…

作者头像 李华
网站建设 2026/8/1 21:38:06

NVIDIA用户必看:obs-vkcapture在NVIDIA显卡上的最佳配置

NVIDIA用户必看:obs-vkcapture在NVIDIA显卡上的最佳配置 【免费下载链接】obs-vkcapture OBS Linux Vulkan/OpenGL game capture 项目地址: https://gitcode.com/gh_mirrors/ob/obs-vkcapture obs-vkcapture是一款专为Linux系统设计的OBS Vulkan/OpenGL游戏捕…

作者头像 李华
网站建设 2026/8/1 21:37:55

3分钟解决Mac鼠标滚动卡顿问题:Mos平滑滚动工具完全指南

3分钟解决Mac鼠标滚动卡顿问题:Mos平滑滚动工具完全指南 【免费下载链接】Mos 一个用于在 macOS 上平滑你的鼠标滚动效果或单独设置滚动方向的小工具, 让你的滚轮爽如触控板 | A lightweight tool used to smooth scrolling and set scroll direction independently…

作者头像 李华
网站建设 2026/8/1 21:34:48

4.2英寸电子墨水屏全平台驱动指南:从SPI原理到实战优化

1. 项目概述:为什么选择4.2英寸电子墨水屏?如果你玩过树莓派或者ESP32这类开发板,大概率会接触到各种显示屏,从炫彩的OLED到常见的TFT-LCD。但当你需要做一个低功耗、长时间显示、甚至在阳光下清晰可见的项目时,比如一…

作者头像 李华