文档与帮助

快速入门

从下载到第一次生成，只需四步：

1. 前往 Agnes AI 平台 注册账号并创建 API Key
2. 下载并安装 Agnes Vision Windows 客户端
3. 启动客户端，在设置页粘贴 API Key 并测试连接
4. 选择生成模式，输入描述，点击生成

获取 API Key

Agnes Vision 依赖 Agnes AI API 提供生成能力。您需要先获取一个有效的 API Key。

1. 打开 platform.agnes-ai.com
2. 注册或登录您的账号
3. 进入 API Key 管理页面，创建新密钥
4. 复制密钥（格式类似 sk-xxxxxxxxxxxx）
5. 在 Agnes Vision 设置页粘贴并测试连接

设置说明

API Base URL

默认值为 https://apihub.agnes-ai.com/v1。一般情况下无需修改。

默认模型

图片模型默认 agnes-image-2.1-flash，视频模型默认 agnes-video-v2.0。可在设置页更改。

输出目录

默认使用 Tauri 应用数据目录下的 AgnesVision/output/。可在设置页自定义其他绝对路径。

视频轮询间隔

默认 5 秒。视频任务创建后，客户端会按此间隔自动查询任务状态。

自动同步上限

默认 60 分钟。达到上限后仅暂停本地轮询，不影响远程任务的实际生成状态。

生成模式

文生图片

输入文字描述即可生成图片。支持设置模型、尺寸（如 1024×1024）、种子参数。建议提供详细的画面描述以获得更可控的结果。

图生图片

上传本地图片或输入公网图片 URL，结合文字描述生成新图片。最多支持 4 张参考图。本地图片路径不会发送到远程服务。

文生视频

用文字描述驱动视频生成。支持设置宽度、高度、帧数、帧率。创建后自动后台轮询进度。

图生视频

上传参考图并输入文字描述生成视频。多张参考图由底层自动合成为网格拼图后提交。

安全说明

• API Key 不进入前端状态管理，不返回给 WebView，不写入日志
• 前端不直接调用 Agnes API，所有请求经过 Rust 层
• 本地输入路径不会进入 Agnes API 请求体
• 本地预览只能读取 Agnes Vision 管理的输入或输出目录
• 运行中的任务不能删除
• 历史记录删除不会删除本地资产文件

常见问题

Agnes Vision 是免费的吗？

客户端本身免费下载和使用。图片/视频生成消耗 Agnes AI API 额度，具体计费请参考 Agnes AI 平台。

需要什么硬件？

不需要独立显卡。所有生成在云端完成，客户端仅需基本的网络连接和显示能力。

可以在 Mac 或 Linux 上使用吗？

当前版本仅支持 Windows 10/11 64 位。Mac 和 Linux 版本在规划中。

API Key 安全吗？

是的。API Key 仅保存在 Rust 层，使用 sk-****abcd 格式掩码显示，前端不可访问完整密钥。

如何获取帮助或反馈问题？

可通过邮箱 youtake@yeah.net 或QQ 24730704 联系作者交流。