Agnes AI官网是 agnes-ai.com,国内站为 agnes-ai.cn,由新加坡 Sapiens AI 团队开发,提供文本、图像、视频全模态 API。免费是真的,但有边界:永久免费的是 Flash 系列,跑进 Artificial Analysis 榜单前十的 Pro Alpha 是付费模型。本文整理官网入口与 API 节点、模型清单与真实参数、免费额度与 Token Plan 价格,以及官方文档中的报错排查表。 Agnes AI官网入口与站点一览
Agnes 分国际站与国内站两套域名,用错节点是国内开发者最常见的"连不上"原因。
注意区分:官网主站是看产品介绍和文档的地方,真正创建密钥要去 platform 子域,而代码里填的 base_url 是 apihub 子域——三个域名各司其职,混用会直接报连接错误。据官方说明,国内站启用时明确了三个"不需要":不需要重新注册、不需要换 API Key、不需要改代码,只需把 base_url 里的域名后缀改为 .cn 即可。
对国内用户而言,Agnes 与 OpenAI、Gemini 等产品最大的不同是:它设有官方国内站点与国内 API 节点,境内可合规使用,不需要任何特殊网络条件。 Agnes AI是什么?公司与产品矩阵
Agnes AI 由新加坡公司 Sapiens AI(SINGAPORE SAPIENS TECHNOLOGY PTE. LTD.)开发运营,官方口径称其为"新加坡本土模型公司,Agnes AI 的母公司"。公司自研文本、图像、视频与推理模型,主打全模态基础模型与面向智能体工具的模型能力(官方提及为 OpenClaw、Hermes 等 Agent 工具供能)。
产品形态上,Agnes 同时覆盖两类用户:
- 面向开发者:全模态 API,兼容 OpenAI 协议,装过 openai 包即可直接调用,无需额外依赖;
- 面向普通用户:官网提供搜索、对话、创作、视频与生产力任务入口,其中包含多模态对话产品 Echo,以及面向编程场景的桌面端工作台与命令行工具(AgnesCode)。
规模数据方面,第三方资料称其于 2025 年 7 月上线 PC 版、同年 9 月推出移动端 App,截至 2026 年 7 月全球注册用户超 300 万。该数据来自第三方整理,未经官方页面二次确认,仅供参考。
Agnes AI的模型清单与能力
模型全部兼容 OpenAI 协议,按模态分为三类:
这里要纠正一个全网流传的错误说法:很多教程写"agnes-2.0-flash 支持 1M 超长上下文",这已经过时。官方模型目录明确说明,临时的 1M 上下文窗口已于 2026 年 6 月因稳定性原因回滚,agnes-2.0-flash 当前官方参考值为 256K 上下文、64K 输出。真正提供 1M 上下文的是付费的 agnes-2.5-pro-alpha。
能力定位上,据 Artificial Analysis 等第三方榜单,Agnes-2.5-Pro-Alpha 在综合智能指数中位列参评模型前十、Terminal-Bench v2.1 得分约 67%;图像与视频模型的 Elo 评分处于主流阵营但并非第一梯队。官方与创始团队对自家视频模型的表态也较为克制,承认与头部视频模型仍有差距。
Agnes AI免费额度与Token Plan价格
回到标题那个问题:免费是真的,但免费的是 Flash 线。官方对免费的表态是"Agnes 2.5 Flash 将继续不限期免费开放",文本与图像模型(含 4K 出图)在免费档即可调用,不要求绑定信用卡。
付费模型单价方面,agnes-2.5-pro-alpha 的公开报价约为每百万 token 输入 0.45 美元、输出 0.90 美元(国内站另有人民币计价口径,约输入 3 元、输出 6 元),视频模型国际定价约 0.30 美元/分钟。两个站点的计价币种与数值口径不同,务必以你注册站点显示的价格为准。
速率上还有一个容易忽略的细节:免费层的并发限制明显低于付费档(第三方观察约为 20 RPM 对 1000 RPM),且生成 4K 图像时的可执行速率远低于 1K。做批量出图的业务务必先算速率,不然脚本会大面积撞限流。
Agnes API接入常见报错排查
| | |
|---|
| | 对照模型文档核对请求;视频请求注意 seconds 是否为字符串 |
| | 重新复制密钥,确认 Authorization 头为 Bearer 加空格再加密钥 |
| | 检查账户余额、Token Plan 状态与密钥类型 |
| | 核对请求路径、模型 ID,以及查询视频结果用的 video_id |
| | |
| | 按 1s→2s→4s→8s 做指数退避重试,持续失败联系支持邮箱 |
几个高频踩坑点:图生图的输入图必须放在 extra_body 的 image 字段,而不是顶层字段;视频请求的 num_frames 必须满足 8n+1(如 81、121、161)且不超过 441,帧率一般设 24;视频为异步任务,需用返回的 video_id 轮询结果;接口返回的图片或视频链接有时效,拿到后应尽快下载到本地。
Agnes AI官网常见问题解答
Q:Agnes AI 官网到底是哪个?
A:国际站 agnes-ai.com,国内站 agnes-ai.cn。注册与创建密钥在 platform 子域,代码调用的 base_url 用 apihub 子域,三者不要混用。
Q:真的是永久免费吗?
A:官方对 Flash 系列的表态是不限期免费,文本与图像(含 4K)均可免费调用。但旗舰 Pro 系列、更高的速率与额度属于付费范畴,不要把"免费"理解成全部模型随便用。
Q:国内用户需要特殊网络吗?
A:不需要。Agnes 设有国内站点与国内 API 节点,境内可合规访问,这与需要境外网络条件的产品不同。
Q:国际站的 Key 能在国内节点用吗?
A:据官方说明,国际站账号与密钥在国内站通用,模型名称、请求参数与调用方式均不变,只需更换 base_url 域名后缀。
Q:免费额度够做生产吗?
A:原型验证、个人项目与小规模测试通常够用;生产环境的高并发与稳定额度需求,建议评估 Token Plan,并重点确认 RPM 限制是否满足业务峰值。
Agnes AI官网与接入的注意事项
- 只认三个官方域名:agnes-ai.com / agnes-ai.cn(官网)、platform.*(控制台)、apihub.*(API 端点)。任何声称"agnes 国内代理""低价代充额度"的第三方站点都不是官方渠道。
- 别信过时的模型参数:网传的"agnes-2.0-flash 支持 1M 上下文"已回滚,当前为 256K。接入前务必以官方模型目录为基准,否则长文本任务会直接超限。
- 分清免费与付费的边界:永久免费的是 Flash 线;进入权威榜单前十的 Pro Alpha 是付费模型。做预算时不要按"全免费"估算。
- 国内站状态需确认:国内站上线初期曾出现"维护中"提示,本文核查时未取得实时状态。若官网打不开,可尝试在国际站获取密钥后调用 .cn 端点,并关注官方公告。
- 密钥不要进代码仓库:API Key 应放在环境变量或密钥管理服务里;一旦泄露,立即在控制台删除旧密钥并重新生成。
- 结果链接有时效:图像与视频的返回 URL 通常会在一段时间后失效,业务系统应及时转存到自己的存储,不要长期外链。
- 合规使用:跨境调用境外节点时需遵守所在地的数据与网络相关法规;涉及个人信息或业务敏感数据的场景,优先使用国内节点并确认数据处理条款。
以上内容中的模型参数、免费额度、Token Plan 价格与速率限制均可能随官方调整而变动,请以 agnes-ai.com、agnes-ai.cn 与 platform 控制台最新公布为准。