目录背景Agnes AI 是什么一、Cursor 用户的痛点二、第一步注册拿 Key2 分钟三、第二步配置 BYOK核心 4 行方式一Settings 界面操作方式二直接编辑 settings.json四、第三步图片和视频接入方式一封装为 Cursor Rule推荐方式二外部脚本调用五、三层模型调度策略Cursor 专属玩法六、实测效果文本编码文生图文生视频七、踩坑避雷速查表八、适用场景总结4 行 JSON 解决额度焦虑参考链接一句话速览Cursor 的 BYOKBring Your Own Key功能 Agnes 免费 API 日常编码零成本。只需在 settings.json 写 4 行配置文本模型无限调用Pro 额度留给真正需要的高级任务。背景Agnes AI 是什么Agnes AI 是新加坡 Sapiens AI 公司旗下的全模态模型品牌自研文本、图像、视频三大模型完全兼容 OpenAI API 格式。自 2026 年 6 月 1 日起三大模型 API无限期、全球范围免费开放——无需绑卡、无 Token 额度上限仅限制每分钟请求数约 30 RPM。而 Cursor 原生支持 BYOK 自定义 API Key两者结合日常编码完全零成本。一、Cursor 用户的痛点Cursor Pro 每月 500 次快请求Fast requests重度用户月底经常排队等待。问题本质不是额度太少而是简单任务也在烧 Pro 额度——格式化代码、写注释、修小 bug这些任务用 Pro 级模型纯属浪费。解法把日常简单任务交给 Agnes 免费模型Pro 额度只用于复杂架构和重构。二、第一步注册拿 Key2 分钟访问https://platform.agnes-ai.com注册登录邮箱 / Google / GitHub无需绑卡、无需手机号进入「设置」→「API 密钥」→ 创建新密钥复制sk-xxxx密钥仅展示一次丢失需重新创建三、第二步配置 BYOK核心 4 行方式一Settings 界面操作Ctrl,打开设置 → 搜索byok开启Cursor BYOK Enabled填入以下 4 个字段配置项填写内容BYOK Endpointhttps://apihub.agnes-ai.com/v1BYOK Modelagnes-2.5-flashBYOK API Keysk-你的密钥BYOK Enabledtrue方式二直接编辑 settings.json按CtrlShiftP→ 搜索Open Settings (JSON)添加{cursor.byok.enabled:true,cursor.byok.endpoint:https://apihub.agnes-ai.com/v1,cursor.byok.model:agnes-2.5-flash,cursor.byok.apiKey:sk-你的API Key}保存后 Cursor 自动重新加载在对话框右下角模型列表中选择 BYOK 模型即可。验证输入你是什么模型正常返回即接入成功。踩坑提醒模型名区分大小写。如果报 503用GET /v1/models接口查实际可用模型名。Endpoint 末尾不要多加/。四、第三步图片和视频接入Cursor 的 BYOK 只支持文本模型直连。图片和视频需要通过 API 直接调用。方式一封装为 Cursor Rule推荐在项目根目录创建.cursorrules文件写入 Agnes 图片/视频 API 调用模板当用户要求生成图片时使用以下 API - 端点POST https://apihub.agnes-ai.com/v1/images/generations - 请求头Authorization: Bearer sk-你的密钥 - 请求体{model: agnes-image-2.1-flash, prompt: 用户描述, size: 1024x1024} - 解析返回的 url 字段 当用户要求生成视频时使用以下 API - 端点POST https://apihub.agnes-ai.com/v1/videos/generations - 请求体{model: agnes-video-v2.0, prompt: 用户描述} - 视频任务为异步需轮询 task_id 查询状态Cursor 读取 Rule 后你在对话框说生成一张赛博朋克城市图它会自动调用 Agnes 图片 API。方式二外部脚本调用写一个简单的 Python 脚本在 Cursor 终端中运行importrequests# 文生图resprequests.post(https://apihub.agnes-ai.com/v1/images/generations,headers{Authorization:Bearer sk-你的密钥},json{model:agnes-image-2.1-flash,prompt:赛博朋克城市夜景霓虹灯光,size:1024x1024})print(resp.json()[data][0][url])五、三层模型调度策略Cursor 专属玩法这是 Cursor 用户最有价值的配置方式——按任务复杂度分配模型不浪费一分钱任务类型推荐模型理由架构设计 / 大规模重构Cursor ProComposer需要顶级推理能力值得烧额度日常编码 / 修 bug / 写函数Agnes BYOK免费能力够用零成本格式化 / 写注释 / 简单问答Agnes BYOK免费最简单的任务绝不用 Pro效果500 次 Pro 额度从月底不够用变成月底还有剩日常编码无限量。六、实测效果文本编码agnes-2.5-flash支持 256K 上下文、Tool Calling日常编码体感与头部付费模型差距不大。前端页面50 个霓虹小球碰撞效果一次生成可跑无报错。文生图通过 API 调用agnes-image-2.1-flash支持最高 4K4096×4096输出十几秒出图免费额度内不扣费。文生视频通过 API 调用agnes-video-v2.0支持 720P/1080P原生同步生成音频最长 18 秒。视频踩坑帧数必须是8n19/17/25…81填错必报错高峰期可能 500错开重试。七、踩坑避雷速查表问题原因解决方案BYOK 模型不显示settings.json 格式错误检查 JSON 语法保存后等 Cursor 重新加载503 “No available channel”模型名大小写错误用GET /v1/models查实际模型名401 认证失败密钥复制不全或带空格重新复制确认无多余字符图片/视频无法在对话框直接调用BYOK 只支持文本直连用 .cursorrules 或外部脚本调用 API429 限流免费版约 30 RPM批量任务间隔 1-2 秒重试视频报错帧数不是 8n1帧数填 9/17/25/33…81八、适用场景场景推荐方案说明日常编码 / 修 bugagnes-2.5-flash BYOK零成本省 Pro 额度架构设计 / 大重构Cursor Pro Composer复杂任务值得用顶级模型产品图 / 海报agnes-image-2.1-flash API4K 输出免费够用快速创意原型文生图 文生视频 API免费跑通流程总结4 行 JSON 解决额度焦虑步骤操作耗时1. 注册拿 Keyplatform.agnes-ai.com 注册 创建密钥2 分钟2. 配 BYOKsettings.json 写 4 行配置1 分钟3. 配图片视频.cursorrules 或外部脚本5 分钟Cursor 是接入 Agnes 最简单的 IDE——不需要安装额外工具、不需要协议转换、不需要环境变量配置4 行 JSON 搞定文本编码。配合三层调度策略Pro 额度省着用、日常编码无限用是 Cursor 重度用户的最优解。参考链接Agnes 官方开发者平台https://platform.agnes-ai.comAgnes 官方文档https://wiki.agnes-ai.com/zh-Hans/docs/overviewAgnes 官方 FAQ免费政策与定价https://wiki.agnes-ai.com/en/docs/faqs本文数据截至 2026年9月14日基于多方信源交叉验证。免费政策与模型版本以官方最新文档为准。觉得有用点赞 收藏 关注后续持续跟进相关内容。声明资源可能存在第三方来源若有侵权请联系删除