目录
-
- [背景：Agnes AI 是什么？](#背景：Agnes AI 是什么？)
- 一、前置准备：两样东西
- [二、第一步：注册拿 Key（2 分钟）](#二、第一步：注册拿 Key（2 分钟）)
- 三、第二步：配置文本模型（核心一步）
- 四、第三步：配置图片和视频模型
- [五、Trae 独有玩法：SOLO 模式 + Agnes 免费模型](#五、Trae 独有玩法：SOLO 模式 + Agnes 免费模型)
- 六、实测效果：三大模型实战验证
-
- [6.1 文本编码](#6.1 文本编码)
- [6.2 文生图](#6.2 文生图)
- [6.3 图生图](#6.3 图生图)
- [6.4 文生视频](#6.4 文生视频)
- 七、踩坑避雷速查表（建议收藏）
- 八、适用场景推荐
- 总结：三步走完整接入
- 参考链接
一句话速览：把 Agnes AI 的三大免费模型接入 Trae IDE，文本编码、4K 生图、音画同步视频全部零成本调用------无需绑卡、无 Token 上限，仅限每分钟请求数。全程界面操作零代码，还能在 SOLO 模式里用 Agnes 模型跑全自动项目构建。
背景：Agnes AI 是什么？
Agnes AI 是新加坡 Sapiens AI 公司旗下的全模态模型品牌，自研文本、图像、视频三大模型，完全兼容 OpenAI API 格式。自 2026 年 6 月 1 日起，三大模型 API 无限期、全球范围免费开放------无需绑卡、无 Token 额度上限，仅限制每分钟请求数（约 30 RPM）。
而 Trae IDE 原生支持自定义 OpenAI 兼容模型，纯界面操作即可完成配置，无需编辑任何配置文件。更关键的是，Trae 的 SOLO 模式可以用自定义模型跑全自动项目构建------这意味着 Agnes 免费模型可以驱动从需求理解到代码生成、测试、预览的完整流程。
一、前置准备：两样东西
| 准备项 | 说明 |
|---|---|
| Trae IDE | 已安装即可（设置 → 模型 → 自定义配置功能） |
| Agnes API Key | 下方第二步获取，免费注册即送 |
二、第一步：注册拿 Key（2 分钟）
- 访问
https://platform.agnes-ai.com - 注册登录（支持邮箱 / Google / GitHub，无需手机号、无需绑卡）
- 进入「设置」→「API 密钥」→ 点击创建新密钥
- 复制
sk-xxxx密钥（仅展示一次，丢失需重新创建）
当前推广期所有模型免费调用，不扣费。免费版约 30 RPM（每分钟请求数），日常开发够用。
三、第二步：配置文本模型（核心一步）
Trae 有两种方式进入模型配置界面：
- 方式一：设置 → 模型 → 添加模型
- 方式二：对话框模型列表 → 添加模型
两种方式进入同一个配置面板。选择「自定义配置」，按下表填写参数：
| 配置项 | 填写内容 | 说明 |
|---|---|---|
| API 格式 | OpenAI |
Agnes 兼容 OpenAI 协议，选这个兼容性最好 |
| 自定义请求地址 | https://apihub.agnes-ai.com/v1 |
注意：不加 /chat/completions 尾缀 |
| 完整 URL 按钮 | 关闭（默认） | 因为 Agnes 的地址不含尾缀，开启会 404 |
| 模型 ID | agnes-2.5-flash |
区分大小写，直接从 Agnes 平台复制 |
| API 密钥 | sk-你的密钥 |
粘贴 Agnes 密钥 |
| 多模态 | 开启 | Agnes-2.5-Flash 支持图片输入 |
踩坑警告 ：模型 ID 是无数人翻车的地方------区分大小写，请从 Agnes 平台复制确认。如果报 503 "No available channel"，说明模型名写错了，用
GET /v1/models接口查实际可用模型名。
高级配置（可选但建议展开）
| 参数 | 建议值 | 说明 |
|---|---|---|
| 模型展示名称 | Agnes 2.5 Flash |
列表中显示的名称，可自定义 |
| 上下文窗口 | 输入 240000 / 输出 16000 | Agnes-2.5-Flash 总计 256K |
| 工具调用轮次 | 保持默认 200 | Agent 任务按需调大，非专业人士别动 |
上下文窗口警告：Trae 的上下文参数是输入+输出的总和。不要盲目拉高------比如模型官配 256K，你非要配 1M，会出现严重降智与失忆。配成模型本身的规格即可。
配置完成后点击「添加模型」，Trae 会自动测试 API Key 是否有效。连接成功后，在对话框右下角模型列表中切换到 Agnes 2.5 Flash 即可开始编码。
验证：输入"你是什么大模型？"，正常返回模型信息即接入成功。
四、第三步：配置图片和视频模型
Trae 的自定义模型只支持文本模型直连。图片和视频必须通过 Skill 技能封装调用。
Skill 自动生成（最简单，推荐）
直接在 Trae 对话框输入以下指令：
我想要使用 Agnes Image 2.1 Flash 模型生图、Agnes Video 2.0 模型生成视频，
访问它的 API 平台 https://agnes-ai.com/doc/overview ，并将它打包成一份 Skill。Trae 会自动读取 Agnes API 文档，生成对应的技能文件和 skill.md。生成后需要做一件事：
把技能文件里所有 YOUR_API_KEY 替换成你自己的 Agnes 密钥，然后在 Trae 技能界面上传修改好的文件即可。
生图使用
在技能列表中选择 Agnes 图像生成技能，输入提示词：
赛博朋克城市夜景，霓虹灯光，电影风格，高细节十几秒出图，支持最高 4K（4096×4096）输出，免费额度内不扣费。
生视频使用
选择 Agnes 视频生成技能，输入提示词：
5 秒视频，亚洲女模特在白色摄影棚穿黑色连衣裙，镜头从全身缓慢移动到半身特写特点：原生同步生成音频，支持 720P/1080P，最长 18 秒。
踩坑提醒（视频必看） ：视频生成有一个硬性规则------帧数必须是
8n+1（如 9、17、25、33...81），填错必报错。另外高峰期可能出现 500 报错，错开高峰重试即可。
五、Trae 独有玩法：SOLO 模式 + Agnes 免费模型
这是 Trae 区别于其他 IDE 的最大亮点。SOLO 模式以 AI 为主导，自动规划并执行从需求理解、代码生成、测试到结果预览的完整流程。而 SOLO 模式支持使用自定义模型。
配置方式
如果你同时安装了 Trae IDE 和 SOLO 桌面端，IDE 的模型配置会自动同步到 SOLO。如果没有同步，在 SOLO 中手动添加：左下角头像 → 设置 → 模型 → 添加模型，参数与上面 IDE 配置完全一致。
使用方式
在 SOLO 模式中，用自然语言描述需求（如"帮我写一个待办事项 Web 应用，支持增删改查和本地存储"），SOLO 会用 Agnes 模型自动完成：需求拆解 → 项目脚手架 → 代码生成 → 测试编写 → 预览部署。
这意味着什么：以前 SOLO 模式用官方模型消耗免费额度或订阅额度，现在接入 Agnes 后，全自动项目构建也是零成本。
六、实测效果：三大模型实战验证
6.1 文本编码
切换到 agnes-2.5-flash，直接编码。256K 上下文窗口、支持 Tool Calling 和 Thinking Mode，日常编码、Agent 工作流、多轮对话都能胜任。SWE-bench Verified 75.6 分，日常代码任务体感与头部付费模型差距不大。跨文件协同修改、主动定位消除 Bug、从零构建完整应用都能搞定。
6.2 文生图
用 Skill 调用 agnes-image-2.1-flash，示例提示词：
一位穿旗袍的女性站在江南水乡的石桥边，晨光柔和，水面倒映着白墙黑瓦，电影级写实风格，浅景深。768x1024实测：十几秒出图，构图、光影、细节都在线，旗袍纹理和背景水乡氛围到位。支持最高 4K（4096×4096）输出。
6.3 图生图
传入参考图 + 描述，模型会基于参考图生成新图。实测效果"像但又不是你"------会带有模型自己的审美风格，适合风格化创作。
6.4 文生视频
用 Skill 调用 agnes-video-v2.0，示例提示词：
5 秒视频，亚洲女模特在白色摄影棚穿黑色连衣裙，镜头从全身缓慢移动到半身特写，同时自然转身。特点：原生同步生成音频，支持 720P/1080P，最长 18 秒。实测生成时间约几分钟。注意：视频人物面部与原图会有差异，这是当前 AI 视频领域共性挑战，非 Agnes 独有。
七、踩坑避雷速查表（建议收藏）
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 503 "No available channel" | 模型 ID 填错或大小写不对 | 用 GET /v1/models 查实际可用模型名 |
| 404 Not Found | 完整 URL 按钮误开启 | 关闭完整 URL 按钮，地址不加 /chat/completions |
| 401 认证失败 | 密钥复制不全、带空格或换行 | 重新复制密钥，确认无多余字符 |
| 模型回复降智/失忆 | 上下文窗口盲目拉高 | 配成模型本身规格（256K），不要配 1M |
| 图片/视频无法直接调用 | Trae 自定义模型只支持文本直连 | 必须通过 Skill 技能模式封装调用 |
| 视频报错 | 帧数不是 8n+1 |
帧数填 9/17/25/33...81 等 8n+1 的值 |
| 视频 500 报错 | 高峰期服务器拥挤 | 错开高峰重试 |
| 429 限流 | 免费版约 30 RPM | 批量任务拆分分次执行，间隔 1-2 秒重试 |
| SOLO 模式未同步模型 | IDE 与 SOLO 未关联 | SOLO 中手动添加，参数与 IDE 一致 |
八、适用场景推荐
| 场景 | 推荐方案 | 说明 |
|---|---|---|
| 日常编码 / Agent 任务 | agnes-2.5-flash 文本模型 | 256K 上下文 + Tool Calling，零成本 |
| SOLO 全自动项目构建 | agnes-2.5-flash | 需求→代码→测试→预览，零成本 |
| 产品图 / 海报 / 氛围图 | agnes-image-2.1-flash Skill | 4K 输出，免费够用 |
| 快速创意原型验证 | 文生图 + 文生视频 | 免费额度跑通流程再决定投入 |
| 短视频素材批量生成 | agnes-video-v2.0 Skill | 音画同步，支持 18 秒 |
总结：三步走完整接入
| 步骤 | 操作 | 耗时 |
|---|---|---|
| 1. 注册拿 Key | platform.agnes-ai.com 注册 + 创建密钥 | 2 分钟 |
| 2. 配文本模型 | 设置 → 模型 → 添加自定义模型 → 填参数 | 1 分钟 |
| 3. 配图片视频 | 对话框输入指令让 Trae 自动生成 Skill | 3-5 分钟 |
Trae 是接入 Agnes 体验最流畅的 IDE------纯界面操作零代码、模型配置自动同步到 SOLO、还能在 SOLO 模式里用免费模型跑全自动项目构建。文本、图片、视频三大模型全部免费，加上 SOLO 全自动编码，四项能力零成本，适合日常编码和内容创作高频使用。
对开发者来说，最实际的改变是：以前在 Trae 里用官方模型，高峰期排队、额度不够用；现在接入 Agnes 后，编码、生图、生视频、甚至 SOLO 自动构建随便用，不用担心排队和额度。免费版 30 RPM 对个人开发够用，高频生产场景可升级 Token Plan（Starter / Plus / Pro 三档）。
参考链接
- Trae 官方文档（自定义模型配置）：
https://docs.trae.ai/ide/models?_lang=zh - Trae 官方文档（SOLO 模式）：
https://docs.trae.ai/ide/solo-mode?_lang=zh - Agnes 官方开发者平台：
https://platform.agnes-ai.com - Agnes 官方文档：
https://wiki.agnes-ai.com/zh-Hans/docs/overview - Agnes 官方 FAQ（免费政策与定价）：
https://wiki.agnes-ai.com/en/docs/faqs
声明：资源可能存在第三方来源，若有侵权请联系删除！
本文数据截至 2026年9月14日，基于多方信源交叉验证。免费政策与模型版本以官方最新文档为准。
觉得有用？点赞 + 收藏 + 关注，后续持续跟进相关内容。