Agnes 2.5 Flash 永久免费了！文本/图像/视频全模态，国内直连，编码还强

生成摘要

AI 生成，仅供参考

最近在折腾 AI 编程工具，发现了一个相当不错的免费 API——Agnes 2.5 Flash。这玩意儿不只是文本模型，文本、图像、视频全都免费，编码能力还出奇地强。关键是国内直连，不用折腾网络。

今天就把这玩意儿从头到尾掰开聊，顺便附上完整的接入教程。

这玩意儿是什么

Agnes 是新加坡 Sapiens AI 团队搞的多模态 AI 平台。2.5 Flash 是 7 月底全量开放的免费模型，官方定位是日常编码、Agent 开发和高频任务的”搬砖工具”。

三个点：永久免费、多模态、编码强。市面上免费的往往编码弱或者只能文本不能出图，编码强的又多是按量计费。Agnes 算是少数把这三件事都做了的。

编码能力到底怎么样

官方数据说 2.5 Flash 在 SWE Atlas 三项指标上大幅提升：

• **QnA（代码库问答）**：从 15.8% 跳到 36.5%
• **RF（问题定位）**：从 11.4% 跳到 29.5%
• **TW（代码修复）**：从 13.5% 跳到 27.5%

数字看着挺唬人。实际用下来，简单对话和单文件代码生成这块，和主流模型差不多，不会差到哪去。但真正拉开差距的是项目理解能力——它不再只看单文件，跨文件的修改更稳定，不会改了 A 炸了 B。Agent 类任务的执行也靠谱了不少，这是 2.5 主要发力的方向。

当然也有短板。复杂推理和大型工程的深度理解，比起付费模型（比如 DeepSeek V4、Claude）还是有差距。但日常搬砖，绰绰有余。

不只是文本，多模态全免费

Agnes 2.5 Flash 免费套餐覆盖了这些：

• **文本/编码**：`agnes-2.5-flash`，永久免费不限 token 总量，512K 上下文窗口
• **文生图/修图**：`agnes-image-2.1-flash`，永久免费
• **文生视频/图生视频**：`agnes-video-v2.0`，永久免费

文本+图像+视频全模态免费的平台，一只手数得过来。Agnes 是其中之一，编码还做得不错。

关于”免费”的几个真相

永久免费不等于无限打。官方对免费档有限制：

• **文本**：允许发起 30 RPM，实际约 20 次/分钟
• **图像**：1K 分辨率约 20 次/分钟，2K 约 10 次/分钟，更高分辨率更慢
• **视频**：允许 2 次/分钟，实际约 1 次/分钟

RPM（每分钟请求数）是瓶颈，不是 token 总量。换句话说，你随便用，别刷太快就行。多个相同类型的 Key 共享同一限制池，开更多 Key 叠不出额度，不用白费力气。

日常用量比较大，或者需要更高并发的话，官方也有 Token Plan 付费档（Starter/Plus/Pro 三档）。入门体验的话免费档完全够用。

国内怎么用

之前 Agnes 的国际站 agnes-ai.com 在国内访问不太稳定。官方已经准备好了国内域名：

• **官网**：`https://agnes-ai.cn`
• **API 端点**：`https://apihub.agnes-ai.cn/v1`
• **开发者控制台**：`https://platform.agnes-ai.cn`

不需要梯子，直接访问就能用。原国际站 Key 不需要更换，改 endpoint 就行。

上手教程：从注册到跑通

第一步：注册拿 Key

打开 https://platform.agnes-ai.cn，注册/登录后进开发者控制台，点 API Keys → 创建 → 复制 Key。免费/默认档即可，不需要选付费套餐。

第二步：验通

找个终端，设置环境变量跑验证：

export AGNES_API_KEY="你复制的Key"
python scripts/verify_agnes_api.py

如果看到 OK model=agnes-2.5-flash 开头，说明通了。

第三步：挂到 OpenCode 或其他工具

OpenCode 手动添加自定义 Provider：

• **Provider ID**：`agnes`
• **Base URL**：`https://apihub.agnes-ai.cn/v1`
• **API Key**：刚才复制的 Key（不要加 `Bearer` 前缀）
• **Model ID**：`agnes-2.5-flash`

用其他兼容 OpenAI 的工具也一样，Base URL 改上面的地址，填 Key 和 model 名。

第四步：试试图像和视频

图像走 POST /v1/images/generations，视频走 POST /v1/videos（异步），别用 chat 模型硬打视频。

和同类比起来怎么样

简单说说我用过的几个免费 API 的对比感受：

• **DeepSeek**：编码强，但只有文本，免费额度有限
• **智谱 GLM-5.3**：ZCode 送 1 亿 token，但有效期只有两天半，过期作废
• **通义千问**：免费额度不少，多模态能力相对基础
• **Agnes 2.5 Flash**：文本+图像+视频全免费，编码能力在线，国内直连——综合来看是目前免费 API 里最全面的一个

不过 Agnes 也有它的问题。RPM 限制在实际使用中确实会卡脖子，尤其是跑自动化脚本或者批量处理的时候。另外它的付费文档和社区资源相对较少，遇到问题主要靠自己翻官方文档。

写在最后 + 胖猫点评

Agnes 2.5 Flash 是个挺实在的免费 API。没有用”免费”当噱头然后暗搓搓限制 token 总量，也没有把多模态能力砍掉只留文本。编码能力虽然不是顶级，但日常开发、写写脚本、做做 Agent 完全够用。

如果你正在找一个免费、国内直连、支持多模态的 AI API，Agnes 2.5 Flash 值得一试。反正注册不要钱，拿个 Key 验个通，几分钟的事，不合适删了也不亏。

注意事项：本地部署请遵守项目 LICENSE 与开源协议；运行前确认硬件满足官方要求；API Key 请妥善保管，不要泄露到公开仓库。

相关链接：

• Agnes 国内官网：`https://agnes-ai.cn`
• API 控制台：`https://platform.agnes-ai.cn`
• Agnes 2.5 Flash 模型页：`https://agnes-ai.cn/zh-Hans/docs/agnes-25-flash`
• OpenCode 集成指南：`https://wiki.agnes-ai.com/en/docs/cid7`
• 模型目录（GitHub）：`https://github.com/AgnesAI-Labs/AgnesAI-Models`

本文由胖猫小栈原创，欢迎转发分享。如需转载请联系授权。