Agnes AI
新加坡 Sapiens AI 旗下的多模态模型服务：同一套 OpenAI 兼容网关覆盖文本对话、生图、视频。提供 Free Access（免费试用档），适合无付费 Key 时开聊与试生图；额度与限速以控制台为准。
官网与入口
| 资源 | 地址 |
|---|---|
| 国际站 | agnes-ai.com |
| 中国站 | agnes-ai.cn |
| API 控制台（注册 / Key） | platform.agnes-ai.com |
| 开发者文档 | agnes-ai.com/en/docs/overview |
| 模型目录（GitHub） | AgnesAI-Labs/AgnesAI-Models |
| API Base URL | https://apihub.agnes-ai.com/v1 |
按地区选国际站或中国站即可；API Key 与 Base URL 以控制台 / 文档当前显示为准。
免费怎么获取（Free Access）
- 打开 platform.agnes-ai.com 注册并登录（常见为邮箱注册；是否要绑卡以页面为准）。
- 进入开发者控制台 → API Keys → 创建并复制 Key（一般以
sk-开头）。 - 在 MiniTavern 用 自定义 (OpenAI)（聊天）或 自定义 (OpenAI Images)（生图）填入 Base URL 与 Key，见下文。
| 项目 | 说明 |
|---|---|
| 免费方式 | Free Access：核心 Flash 系列可免费调用（有 RPM / fair-use 限速），适合个人试用与 demo |
| 付费升级 | Token Plan：更高 TPS / 月额度，面向生产与高频 Agent（非必须） |
| 限速参考（免费档） | 文本约 20 RPM；生图按分辨率（1K 约 20 RPM，越高越严）；视频约 1 RPM（官方 Token Plan FAQ） |
| 绑卡 | Free Access 通常不强制；正式商用或更高限额再考虑 Token Plan |
政策会调整。若控制台显示某模型需 Token Plan，或返回 429，以官网与账户权限为准。
模型列表
下列为公开文档与模型目录中的常见 ID（大小写敏感）。Flash 多为免费档；带 Pro 的一般为付费推理模型。
文本（对话 / 视觉理解）
走 Chat Completions：POST /v1/chat/completions。在 MiniTavern 选 自定义 (OpenAI)。
| 模型 ID | 说明 |
|---|---|
agnes-2.5-flash | 推荐：对话、编码、工具调用、多轮与图像理解；上下文约 512K |
agnes-2.0-flash | 上一代 Flash，兼容备用 |
agnes-2.5-pro / agnes-2.5-pro-alpha | 付费推理档（高级编码 / 科学推理等），勿当免费档 |
图片（文生图 / 图生图）
走 Images：文生图与图生图均为 POST /v1/images/generations（图生图在 body 里带 image，不是 OpenAI 的 /images/edits）。在 MiniTavern 选 自定义 (OpenAI Images)，Base URL 同为 https://apihub.agnes-ai.com/v1；App 对自定义协议会按此路由，测连带参考图也会打 generations。
| 模型 ID | 说明 |
|---|---|
agnes-image-2.1-flash | 推荐：高信息密度生图与编辑，灵活尺寸 |
agnes-image-2.0-flash | 文生图 / 图生图，URL 或 Base64 输出 |
视频（文生视频 / 图生视频）
走 Videos：POST /v1/videos（异步任务）。常见 ID：
| 模型 ID | 说明 |
|---|---|
agnes-video-v2.0 | 文生视频、图生视频、多图/关键帧等 |
agnes-video-v2.5（或文档中的 Video 2.5） | 新一代视频接口，以官方视频文档为准 |
MiniTavern 当前无内置视频生成入口；上表便于对照官网能力。聊天与生图可先用 Flash 文本 / 图像模型。
在 MiniTavern 里怎么填
通用步骤见 模型连接。
聊天
路径：设置 → 模型 → 模型连接 → 新建
- 平台选 自定义 (OpenAI)
- Base URL：
https://apihub.agnes-ai.com/v1 - 粘贴 API Key
- 模型 ID 填
agnes-2.5-flash（或控制台列表中的其它文本模型） - 测试 → 成功后设为默认
生图
路径：设置 → 生图 → 生图连接
- 平台选 自定义 (OpenAI Images)
- Base URL 同上
- 同一 Key；模型填
agnes-image-2.1-flash等 - 测连后再用于
/imagine或生图入口
聊天连接与生图连接可分开：例如聊天用 agnes-2.5-flash，生图用 agnes-image-2.1-flash。