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

Agnes AI 全攻略从平台认识到 CodeBuddy 接入Agnes AI 是近期备受关注的免费 AI 服务平台以其全模态模型永久免费开放的策略迅速出圈。本文详细介绍 Agnes AI 是什么、有哪些能力以及如何将它的 API 接入 CodeBuddy 中使用。一、Agnes AI 是什么Agnes AI 是新加坡 Sapiens AI 团队推出的 AI 服务平台创始人为 Bruce Yang。其核心定位是面向开发者和创作者提供多模态 AI 模型服务覆盖文本、图像、视频三大主流模态。关键里程碑时间事件2024年底-2025年初Agnes AI 正式起步2025年7月PC版上线2025年9月移动端App推出两个月新增注册用户突破300万2026年6月1日宣布无限期免费开放文本、图像、视频全模态模型API2026年7月13日发布新一代高性能文本模型Agnes-2.5-Flash同步上线Agnes Code桌面端截至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 的基础信息如下配置项值Base URLhttps://apihub.agnes-ai.com/v1认证方式Authorization: Bearer YOUR_API_KEY协议兼容性OpenAI 兼容风格Chat Completions 端点POST /v1/chat/completions中国用户注意国内站官网为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登录后进入API平台侧边栏点击「API密钥」栏目点击「创建新的密钥」自定义一个名称系统生成一串密钥格式类似sk-xxx...⚠️ 重要密钥仅单次展示关闭页面后无法再次查看请立即复制并妥善保存。五、在 CodeBuddy 中配置 Agnes AI方法一通过界面配置推荐打开 CodeBuddy点击顶部模型下拉框滑动至底部选择「配置自定义模型」在配置弹窗中供应商分类选择「自定义/Custom」填入以下信息配置项填写内容模型名称 (Model Name)agnes-2.0-flash稳定版或agnes-2.5-flash灰度用户API 地址 (API URL)https://api.agnes-ai.cn/v1API Key粘贴你刚才保存的密钥点击保存返回对话页面即可选择使用方法二通过models.json文件配置找到 CodeBuddy 的配置文件用户级全局~/.codebuddy/models.json项目级项目根目录/.codebuddy/models.json编辑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]}保存文件重启 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 Key2. 模型不可用如果使用agnes-2.5-flash返回不可用说明账号未进入灰度名单解决方案改用agnes-2.0-flash这是稳定可用版本3. 配置不生效确认models.json格式正确JSON 语法无误重启 CodeBuddy使配置生效七、总结Agnes AI 的核心优势可以概括为优势说明永久免费文本、图像、视频全模态 API 无限期免费不限调用量多模态覆盖一套 API 覆盖文本对话、图像生成、视频创作三大能力OpenAI 兼容无缝接入 CodeBuddy、Cursor 等支持自定义模型的主流工具超长上下文Agnes-2.0-Flash 支持 1M Token 上下文窗口对于个人开发者和小团队来说Agnes AI 提供了一个零成本、全功能的 AI 能力入口。只需注册账号、获取 API Key即可在 CodeBuddy 等编程工具中免费使用。根据官方文档Agnes AI 的免费 API 确实有调用频率限制下面我把它补充到之前的教程里。八Agnes AI API 调用频率限制Agnes AI 的“无限期免费”指的是不限制总调用次数但为了保护服务稳定性对调用频率RPM和订阅配额做了限制。这些数值是公开参考值可能会调整。1. 文本模型 (如 agnes-2.0-flash)RPM (每分钟请求数) 限制用户类型允许发起 RPM实际执行 RPM免费/默认用户3020企业认证用户6040Token Plan 用户10001000说明你注册后默认就是“免费/默认用户”因此文本模型的实际调用频率约为每分钟20次。这个限制对个人编程等低频场景通常是足够的。订阅配额 (Token Plan 用户)套餐agnes-2.0-flash 请求次数Starter每5小时 1,500次每周 15,000次Plus每5小时 7,500次每周 75,000次Pro每5小时 30,000次每周 300,000次说明这是针对付费用户的额外限制与RPM同时生效。免费用户没有此配额限制。2. 图像模型 (如 agnes-image-2.1-flash)RPM 限制按分辨率区分用户类型分辨率允许发起 RPM实际执行 RPM免费/默认1K3020免费/默认2K2010免费/默认3K21免费/默认4K11订阅配额 (Token Plan 用户)所有套餐均为每天 4,000 张。3. 视频模型 (如 agnes-video-v2.0)RPM 限制用户类型实际执行 RPM免费/默认1企业认证用户2Token Plan 用户5订阅配额 (Token Plan 用户)所有套餐均为每天 500 秒。 重要说明限制级别上述限制是针对单个 API Key的。如果需求较高可以考虑申请多个 Key 进行分布式调用。超出限制如果达到频率限制API 会返回错误需要等待片刻后再重新发起请求。配置建议对于在 CodeBuddy 中的日常编程使用每分钟 20 次的文本模型调用限制通常是足够的。