Agnes AI 全攻略：从平台认识到 CodeBuddy 接入

Agnes AI 全攻略：从平台认识到 CodeBuddy 接入

Agnes AI 是近期备受关注的免费 AI 服务平台，以其全模态模型永久免费开放的策略迅速出圈。本文详细介绍 Agnes AI 是什么、有哪些能力，以及如何将它的 API 接入 CodeBuddy 中使用。

一、Agnes AI 是什么？

Agnes AI 是新加坡 Sapiens AI 团队推出的 AI 服务平台，创始人为 Bruce Yang。其核心定位是面向开发者和创作者提供多模态 AI 模型服务，覆盖文本、图像、视频三大主流模态。

关键里程碑

截至2026年7月，Agnes AI 团队已位列全球AI Lab排名第9，所属公司估值超过1亿美元。

注：

博客：

https://blog.csdn.net/badao_liumang_qizhi

二、核心模型与能力

Agnes AI 提供三大类免费模型：

1. 文本模型

• Agnes-2.0-Flash：主力免费文本模型，支持1M Token超长上下文窗口，覆盖对话、代码编写、逻辑推理、智能体工具调用等场景
• Agnes-2.5-Flash：在2.0基础上优化的灰度升级模型，重点提升代码理解、Bug修复、多文件修改、多步骤任务执行和复杂推理能力

2. 图像模型

• Agnes-Image-2.1-Flash：支持文生图、图生图，可做海报、素材、产品渲染等

3. 视频模型

• Agnes-Video-V2.0：支持文生视频、图生视频和关键帧动画，原生音画同步

模型性能参考

在真实Linux终端智能体基准测试Terminal-Bench v2.1中，Agnes 2.5 Pro Alpha 得分为67%。Agnes-2.5-Flash 的定位是开发者日常编程、Agent和高频开发任务的主力模型。

注意：Agnes-2.5-Flash 目前处于灰度发布阶段，仅对进入灰度名单的用户开放。如果你的账号暂未开通，请使用agnes-2.0-flash作为稳定回退模型。

三、API 基础信息

根据官方文档，Agnes AI API 的基础信息如下：

中国用户注意：国内站官网为https://agnes-ai.cn/，API 地址与国际站相同，均为https://apihub.agnes-ai.com/v1。

四、注册账号并获取 API Key

步骤 1：访问平台并注册

访问 Agnes AI 开发者平台：

• 国际站：https://platform.agnes-ai.com/
• 国内站：https://platform.agnes-ai.cn/

使用邮箱注册即可，无需手机号实名。注册时不需要绑定信用卡或填写支付信息。

步骤 2：创建 API Key

1. 登录后，进入API平台侧边栏
2. 点击「API密钥」栏目
3. 点击「创建新的密钥」，自定义一个名称
4. 系统生成一串密钥（格式类似sk-xxx...）

⚠️ 重要：密钥仅单次展示，关闭页面后无法再次查看，请立即复制并妥善保存。

五、在 CodeBuddy 中配置 Agnes AI

方法一：通过界面配置（推荐）

1. 打开 CodeBuddy，点击顶部模型下拉框
2. 滑动至底部，选择「配置自定义模型」
3. 在配置弹窗中，供应商分类选择「自定义/Custom」
4. 填入以下信息：

5. 点击保存，返回对话页面即可选择使用

方法二：通过models.json文件配置

1. 找到 CodeBuddy 的配置文件：

   • 用户级（全局）：~/.codebuddy/models.json
   • 项目级：<项目根目录>/.codebuddy/models.json

2. 编辑models.json，在models数组中添加以下配置：

{"models":[{"id":"agnes-2.0-flash","name":"Agnes AI (2.0 Flash)","vendor":"Agnes AI","apiKey":"sk-此处替换为你的API Key","url":"https://api.agnes-ai.cn/v1"}],"availableModels":["agnes-2.0-flash"]}

3. 保存文件，重启 CodeBuddy使配置生效

添加多个模型（可选）

如果想同时配置多个 Agnes 模型以便切换：

{"models":[{"id":"agnes-2.0-flash","name":"Agnes 2.0 Flash","vendor":"Agnes AI","apiKey":"sk-你的API Key","url":"https://apihub.agnes-ai.com/v1/chat/completions"},{"id":"agnes-2.5-flash","name":"Agnes 2.5 Flash","vendor":"Agnes AI","apiKey":"sk-你的API Key","url":"https://apihub.agnes-ai.com/v1/chat/completions"}],"availableModels":["agnes-2.0-flash","agnes-2.5-flash"]}

六、常见问题排查

1. 401 鉴权失败

• 检查 API Key 是否复制完整（包括sk-前缀）
• 确认 API Key 没有多余的空格或换行符
• 尝试重新生成一个新的 API Key

2. 模型不可用

• 如果使用agnes-2.5-flash返回不可用，说明账号未进入灰度名单
• 解决方案：改用agnes-2.0-flash，这是稳定可用版本

3. 配置不生效

• 确认models.json格式正确（JSON 语法无误）
• 重启 CodeBuddy使配置生效

七、总结

Agnes AI 的核心优势可以概括为：

对于个人开发者和小团队来说，Agnes AI 提供了一个零成本、全功能的 AI 能力入口。只需注册账号、获取 API Key，即可在 CodeBuddy 等编程工具中免费使用。

根据官方文档，Agnes AI 的免费 API 确实有调用频率限制，下面我把它补充到之前的教程里。

八：Agnes AI API 调用频率限制

Agnes AI 的“无限期免费”指的是不限制总调用次数，但为了保护服务稳定性，对调用频率（RPM）和订阅配额做了限制。这些数值是公开参考值，可能会调整。

1. 文本模型 (如 agnes-2.0-flash)

RPM (每分钟请求数) 限制

说明：你注册后默认就是“免费/默认用户”，因此文本模型的实际调用频率约为每分钟20次。这个限制对个人编程等低频场景通常是足够的。

订阅配额 (Token Plan 用户)

说明：这是针对付费用户的额外限制，与RPM同时生效。免费用户没有此配额限制。

2. 图像模型 (如 agnes-image-2.1-flash)

RPM 限制（按分辨率区分）

订阅配额 (Token Plan 用户)：所有套餐均为每天 4,000 张。

3. 视频模型 (如 agnes-video-v2.0)

RPM 限制

订阅配额 (Token Plan 用户)：所有套餐均为每天 500 秒。

📌 重要说明

1. 限制级别：上述限制是针对单个 API Key的。如果需求较高，可以考虑申请多个 Key 进行分布式调用。
2. 超出限制：如果达到频率限制，API 会返回错误，需要等待片刻后再重新发起请求。
3. 配置建议：对于在 CodeBuddy 中的日常编程使用，每分钟 20 次的文本模型调用限制通常是足够的。