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。