Agnes AI 帮助中心

Agnes AI，让世界级 AI 属于每一个人。

当前 Skill 版本：v1.3.1（2026-09-09 更新）

本仓库是 Agnes AI API 的非官方帮助资源集合，包含完整 API 文档与通用支持 Skill，帮助开发者快速接入 Agnes AI 全模态 API（文本、图像、视频）。

📢 重要公告

Agnes 3.0 Flash 已上线：面向 Agent 编程与工具驱动任务的新一代文本模型，当前免费！

✅ 所有 Flash 系列模型（文本 / 图像 / 视频）目前全部免费，仅 Pro 推理系列与 agnes-video-2.5 为付费模型
✅ 最新文本模型 agnes-3.0-flash：512K 上下文、65,536 最大输出、三端点（Chat Completions / Responses / Anthropic 兼容 Messages）、支持 Thinking 模式
✅ 最新图像模型 agnes-image-2.5-flash：整体能力全面超过 2.1 Flash，参数与尺寸完全一致，直接换模型名即可升级
✅ 注册官网 → 生成 KEY → 直接调用
✅ 文本、图像、视频全能适配，模型持续升级

最新模型速览：

模态	最新模型	状态
文本 / Agent 编程	`agnes-3.0-flash`	✅ 免费
图像生成 / 编辑	`agnes-image-2.5-flash`	✅ 免费
视频生成	`agnes-video-2.5-flash`	✅ 免费（限时）
视频生成（高清付费）	`agnes-video-2.5`	💰 付费

官方平台： https://platform.agnes-ai.com

📦 仓库内容

文件	说明	用途
`agnes-ai-api-documentation.md`	完整 API 文档	整合官方全部接口信息，供 Agent 读取（带版本号）
`SKILL.md`	通用支持 Skill	兼容 OpenClaw / Claude Code / Claude Desktop / Hermes / Codex / WorkBuddy / Cherry Studio / Opencode / Kimi Work（加载时检查更新）

🚀 快速开始

方式一：Skill（⭐ 推荐，AI 工具链集成）

将 SKILL.md 放入你的 AI 工具 Skill 目录，即可让 Agent 自动：

指导新用户完成 Agnes AI 接入
诊断 401/400/429/500/503 等错误
排查视频排队过长、图像生成失败等问题
指导 Thinking 模式、流式输出、工具调用等高级功能
指导 Codex、OpenClaw、Hermes、Claude CLI/Desktop、WorkBuddy、Cherry Studio、Opencode 等工具集成

兼容工具： OpenClaw、Claude Code、Claude Desktop、Hermes、Codex、WorkBuddy、Cherry Studio、Opencode、Kimi Work

📋 一键安装（复制发给 Agent）：

请读取并安装 Agnes AI 支持 Skill：https://github.com/lj1270998580-crypto/Agnes-help-skill

安装完成后，只需配置 Agnes API Key 即可使用。告诉 Agent"我要生图""我要生视频"，Agent 会自动判断并执行。

方式二：Agnes 创意空间（推荐自助创作与排查）

无需下载，直接访问 Agnes 创意空间 在线使用：

🔗 https://ailabing.cn/tools/agnes-creative-space/

功能：

✨ 生成模式：文生图、图生图、文生视频、图生视频
💬 对话模式：Agnes AI 智能助手，支持图片分析、自助排查问题、接入指导
🎨 参数调节：支持多种尺寸比例、自定义参数调整
🔑 API Key 设置：输入自己的 Agnes API Key 即可直接使用

适用场景：

快速体验 Agnes AI 图像/视频生成能力
通过对话模式自助排查问题、获取接入建议
无需搭建环境，浏览器直接创作

方式三：API 文档（推荐 Agent / 开发者）

agnes-ai-api-documentation.md 整合了 Agnes AI 官方文档的全部内容：

概述与核心能力
Agnes 3.0 Flash（最新 · 免费）：三端点、512K 上下文、65,536 最大输出、Thinking 模式与示例
Agnes 2.0 Flash / 2.5 Flash 完整参数与示例
Agnes 2.5 Pro / Pro Beta / Pro Alpha（付费推理）参数与价格
Agnes Image 2.0 / 2.1 / 2.5 Flash完整参数与示例
Agnes Video 2.5 / 2.5 Flash / V2.0 完整参数与示例（含异步轮询与画幅像素表）
Token Plan 订阅配额与 RPM 限制
隐私政策与服务条款

自动更新提醒

本仓库的所有文件都支持版本检查与更新提醒：

SKILL.md：每次被 Agent 加载时，Agent 会检查 GitHub 最新 commit，有更新则在回复开头提醒用户
API 文档：文件头部标注版本号，建议定期同步最新版

手动检查更新方式：

访问 GitHub 仓库查看最新 commit：https://github.com/lj1270998580-crypto/Agnes-help-skill
或直接让 Agent 执行：请检查 Agnes AI 支持 Skill 是否有更新

🔑 接入要点速记

Base URL（国际）: https://apihub.agnes-ai.com/v1
Base URL（国内）: https://apihub.agnes-ai.cn/v1
Headers:
  Authorization: Bearer YOUR_API_KEY
  Content-Type: application/json

模型名称：

Agent 编程 / 工具调用（最新）：agnes-3.0-flash（免费） — 512K 上下文、65,536 最大输出、Chat Completions / Responses / Messages 三端点、支持 Thinking
通用对话：agnes-2.5-flash（免费）
编程/Agent/推理：agnes-2.5-flash（免费）
高级推理（付费，GA）：agnes-2.5-pro
高级推理（付费，Beta）：agnes-2.5-pro-beta
高级推理（付费，Alpha）：agnes-2.5-pro-alpha
兼容旧版：agnes-2.0-flash（免费）
图像生成（最新 · 推荐）：agnes-image-2.5-flash（免费）
图像生成：agnes-image-2.1-flash（免费）
视频生成（推荐 / 免费）：agnes-video-2.5-flash
视频生成（付费，高清）：agnes-video-2.5
视频生成（旧版 / 免费）：agnes-video-v2.0

⚠️ 视频接口重要提醒：

🎬 Agnes Video 2.5 Flash 已正式上线，限时免费（$0/秒）：支持 text / keyframe / reference 三种模式，详见国际站文档 / 国内站文档
**Agnes Video 2.5（付费高清版）**也已上线：720P/1080P/1K/2K 四档（2026-09 起取消 960P），reference 模式支持视频输入，详见国际站文档 / 国内站文档
必须用 video_id 查询视频结果：GET /agnesapi?video_id=<ID>
不要用 task_id 查询，会导致排队异常延长（超过 5 分钟大概率是接口搞错了）

📖 Agnes Help Skill 教程图

一图看懂：如何安装 Skill、如何用 Skill 生图/生视频、如何用 Skill 接入工具、如何用 Skill 排查问题

Agnes Help Skill 教程信息图

📚 官方与社区资源

资源	链接
官方平台	https://platform.agnes-ai.com
官方文档（国际站）	https://www.agnes-ai.com/zh-Hans/docs/overview
官方文档（国内站）	https://www.agnes-ai.cn/zh-Hans/docs/overview
操作手册	https://agnes-ai.com/doc/常用接入文档
文本文档（3.0 Flash · 国际站）	https://www.agnes-ai.com/zh-Hans/docs/agnes-30-flash
文本文档（3.0 Flash · 国内站）	https://www.agnes-ai.cn/zh-Hans/docs/agnes-30-flash
图像文档（Image 2.5 Flash · 国际站）	https://www.agnes-ai.com/zh-Hans/docs/agnes-image-25-flash
视频文档（2.5 · 国际站）	https://www.agnes-ai.com/zh-Hans/docs/agnes-video-25
视频文档（2.5 · 国内站）	https://www.agnes-ai.cn/zh-Hans/docs/agnes-video-25
视频文档（2.5 Flash · 国际站）	https://www.agnes-ai.com/zh-Hans/docs/agnes-video-25-flash
视频文档（2.5 Flash · 国内站）	https://www.agnes-ai.cn/zh-Hans/docs/agnes-video-25-flash
视频文档（v2.0）	https://agnes-ai.com/doc/agnes-video-v20
OpenClaw 接入	https://agnes-ai.com/doc/cid1
Hermes 接入	https://agnes-ai.com/doc/cid2
Claude CLI 接入	https://agnes-ai.com/doc/cid3
Claude Desktop 接入	https://agnes-ai.com/doc/cid4
WorkBuddy 接入	https://agnes-ai.com/doc/cid5
Cherry Studio 接入	https://agnes-ai.com/doc/cid6
Opencode 接入	https://agnes-ai.com/doc/cid7
Codex++ 接入	https://agnes-ai.com/doc/cid8
常见问题 QA	https://icn1d2hdv39m.feishu.cn/wiki/R7TEwjadJibD62kWeS9cubtpnPi
Bug 反馈与需求建议	https://github.com/AgnesAI-Labs/Agnes-AI/issues
反馈进度看板	https://github.com/users/AgnesAI-Labs/projects/1
支持邮箱	[email protected]

🔄 更新记录

日期	更新内容
2026-09-09	仓库说明全面更新：公告区改为 Agnes 3.0 Flash 上线口径并新增「最新模型速览」表；顶部标注当前 Skill 版本；API 文档清单补充 3.0 Flash、Image 2.5 Flash 与 Token Plan/RPM 章节；资源表新增 3.0 Flash（国际/国内站）与 Image 2.5 Flash 官方文档链接；同步修正 `agnes-ai-assistant.html`（移除已下线的 `agnes-1.5-flash`，改为 3.0 Flash / 2.5 Flash / Image 2.5 Flash / Video 2.5 系列）与 API 文档中 3 处下线模型示例；SKILL.md 旧公告标注为历史并修正「全模态免费」的过时口径；Skill 版本更新至 v1.3.1
2026-09-09	新增 Agnes 3.0 Flash：`agnes-3.0-flash`，面向 Agent 编程与工具驱动任务，512K 上下文 / 65,536 最大输出，支持 Chat Completions、Responses、Anthropic 兼容 Messages 三端点与 Thinking 模式，当前免费（刊例价 $0.005/$0.05/$0.15，现价全 $0）；新增 Agnes Image 2.5 Flash：`agnes-image-2.5-flash`，整体能力全面超过 2.1 Flash，参数与尺寸完全一致可直接换名升级，当前免费；`agnes-video-2.5` 分辨率档位更新：`960P` 取消，改为 `720P` / `1080P` / `1K` / `2K`，补充三档画幅像素表、参考媒体限制（图片 8 / 视频 1 / 音频 3，总数 ≤12）与音画协同说明；`agnes-video-2.5-flash` 补充参考音频上限 3 段与 720P 实测像素表；Skill 版本更新至 v1.3.0
2026-08-27	核验官方 Token Plan FAQ 与定价页：RPM 数值全部确认无误（文本 20/40/1000，图片 1K:20/2K:10/3K-4K:1，视频 1/2/5）；新增 Token Plan 订阅配额说明（文本 `agnes-2.5-flash` 每 5 小时 1,500~30,000 次、图片每天 4,000 张、视频每天 500 秒）；明确所有 Flash 系列模型当前全部免费（文本/图像/视频均 $0，仅 Pro 系列与 `agnes-video-2.5` 付费）；补全 `agnes-video-2.5` 输入视频时长计入总时长的计费规则；模型选择表统一标注免费/付费；Skill 版本更新至 v1.2.22
2026-08-27	同步官方文档大版本更新：`agnes-2.5-pro-alpha` 已转付费模型（Context 1M，Cache hit $0.045，权重 Apache 2.0 开源）；新增付费推理模型 `agnes-2.5-pro`（GA）与 `agnes-2.5-pro-beta`（Beta，$0.10/$0.30/1M）；新增视频模型 `agnes-video-2.5`（付费高清，720P/960P/2K，reference 支持视频输入）；`agnes-2.5-flash` 与 Pro 系列补充 Responses / Messages 端点；修正 `agnes-2.0-flash` 价格（$0.03/$0.15）与图像模型按张计费明细（1K $0.010–4K $0.024，前 3 张参考图免费）；官方文档链接统一至新站 /zh-Hans/docs；Skill 版本更新至 v1.2.21
2026-08-27	Agnes Video 2.5 Flash 正式上线，限时免费（$0/秒，原价 $0.025/秒）：新增模型 `agnes-video-2.5-flash`（`POST /v1/videos`），支持 text / keyframe / reference 三种模式，`size` 固定 `"720P"`，`seconds` 支持 `"4"`–`"12"`，`reference` 模式最多 5 张图片；官方文档同步更新（国际站 / 国内站）；同步更新 Skill 版本至 v1.2.20
2026-07-28	移除 HTML 交互式助手板块（对用户帮助有限）；`agnes-2.5-pro-alpha` 更新为测试中状态（暂无付费通道）；仓库描述与文档同步为最新版
2026-07-28	新增国内 .cn 域名支持：Base URL（国内）`https://apihub.agnes-ai.cn/v1`，方便国内用户直接访问；同步更新 Skill 版本至 v1.2.18
2026-07-27	新增 Agnes 2.5 系列模型支持：`agnes-2.5-flash`（2.0 升级版，API 兼容，512K/65.5K，免费）和 `agnes-2.5-pro-alpha`（付费推理模型，262K，$0.45/$0.90/1M）；`agnes-1.5-flash` 已从模型列表移除
2026-07-27	同步官方视频文档更新：补充 ~18s 视频时长配置（441帧@24fps）、支持 480p/720p/1080p 三档分辨率、5 种宽高比、关键帧动画模式；经全面检查，官方暂未发布新模型
2026-06-30	同步官方 Token Plan 文档更新：图片模型支持 1K/2K/3K/4K 四档分辨率，RPM 按分辨率分档（1K:20, 2K:10, 3K/4K:1）；文本模型 RPM 20，视频模型 RPM 1；尺寸必须是 16 的倍数，否则返回 500 错误；新增 Token Plan 订阅损耗说明
2026-06-30	同步官方文档更新：Opencode 接入指南从通用模板升级为完整配置指南（含 CLI 配置、Desktop 配置、环境变量设置、验证步骤），修复章节编号错误（17.x → 18.x）
2026-06-23	新增自动更新检查功能：Skill 加载时自动检测版本，读取更新日志告知用户具体更新内容，并询问是否更新；新增问题反馈与官方渠道指引章节（Bug 反馈、需求建议、进度查询三种场景）
2026-06-23	视频生成 RPM 限制调整为 1（每分钟内只能生成 1 个视频），文本/图像模型保持 RPM 20；同步更新所有文档中的 RPM 说明
2026-06-13	新增 Agnes 创意空间（https://ailabing.cn/tools/agnes-creative-space/）为方式二，支持在线生成（文生图/图生图/文生视频/图生视频）和对话模式自助排查问题
2026-06-10	隐藏社区 Skill 推荐（可能未及时更新），仅保留本仓库官方维护的内容
2026-06-09	Skill 改为方式一（⭐ 推荐），新增 Agnes Help Skill 教程信息图和完整使用说明（生图/生视频、接入工具、排查问题三大场景）
2026-06-08	Agnes-2.0-Flash 上下文窗口回退：官方从 1M 回退至 256K（Context 1M → 256K，Max Output 1M → 64K），此前 1M 支持因稳定性问题已回退
2026-06-07	精简触发词列表，新增 Prompt 模板库章节（文生图/图生图/视频/文本模板）
2026-06-06	修复图生图 `image` 参数位置：必须放在 `extra_body` 中，不能放请求体顶层（官方文档错误修正）
2026-06-06	补充 Codex++ 官方接入指南（区分 GUI 工具与 CLI 工具）
2026-06-06	初始版本：整合官方文档、创建交互式 HTML 助手、编写通用 Skill

⚠️ 免责声明

本仓库为社区整理的非官方资源，内容基于 Agnes AI 官方公开文档。如有与官方文档冲突之处，请以官方文档为准。

Agnes AI 官方公司：Sapiens AI / Agnes AI