# Agnes AI Studio

**Repository Path**: igooc/Agnes-AI-Studio

## Basic Information

- **Project Name**: Agnes AI Studio
- **Description**: 是一个基于 Agnes AI 接口封装的本地化 AI Studio 工具项目，提供开箱即用的对话、文生图、图生图、文生视频、图生视频能力。项目包含本地代理服务、前端控制台界面以及一键打包脚本，适合个人学习、演示、内网分发和快速部署使用。

项目目标是降低 AI 接口调用门槛，让用户无需自行处理跨域、请求代理和运行环境问题，即可在本地浏览器中使用统一的 AI 工作台。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-10-11
- **Last Updated**: 2026-10-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# Agnes AI Studio

#### 介绍
 是一个基于 Agnes AI 接口封装的本地化 AI Studio 工具项目，提供开箱即用的对话、文生图、图生图、文生视频、图生视频能力。项目包含本地代理服务、前端控制台界面以及一键打包脚本，适合个人学习、演示、内网分发和快速部署使用。

项目目标是降低 AI 接口调用门槛，让用户无需自行处理跨域、请求代理和运行环境问题，即可在本地浏览器中使用统一的 AI 工作台。
使用agnes-ai提供免费的api
#### 软件架构
项目整体采用“静态前端 + 本地 Python 代理服务 + 外部 Agnes AI API”的架构



#### 安装教程

##### 方式一：源码运行

1. 安装 Python 3.10 及以上版本  
   建议使用 Python 3.13 或与你当前环境一致的版本。

2. 下载或克隆项目到本地目录，例如：
   `E:\XX\XX`

3. 双击运行：
   `start.bat`

4. 浏览器打开：
   `http://localhost:8765`

##### 方式二：使用整合包运行

1. 打开整合包目录：
   `release_build\AgnesAIStudio`

2. 双击运行：
   `start.bat`

3. 浏览器自动或手动访问：
   `http://localhost:8765`

#### 使用说明

1. 启动项目  
   运行 `start.bat` 或整合包中的 `start.bat`，启动本地代理服务。

2. 配置 API Key  
   打开页面后，在左侧配置区域输入 Agnes AI 的 API Key。

3. 使用对话功能  
   在“对话”页面输入问题，点击发送，即可调用文本模型进行交互。
   <<<<<<< HEAD

4. 使用图像功能  
   在“画图”页面输入提示词，选择模型、尺寸和数量后生成图片。
   =======
   ![输入图片说明](1.png)

4. 使用图像功能  
   在“画图”页面输入提示词，选择模型、尺寸和数量后生成图片。
   ![输入图片说明](2.png)
>>>>>>> e03b94dfd1cc58bbbb4324c232c5df61d56522aa

5. 使用视频功能  
   在“视频”页面输入提示词或图像地址，提交任务后系统会自动轮询任务状态。  
   如果 Agnes 返回有效视频地址，页面会自动显示视频。  
   如果接口长期未返回可播放地址，页面会显示“超时，暂时无法显示出视频”。

   =======
   ![输入图片说明](3.png)
>>>>>>> e03b94dfd1cc58bbbb4324c232c5df61d56522aa

6. 查看日志  
   点击左侧“日志”页面，可查看错误、警告和运行详情，便于排障。






#### 目录说明

```text
api/
├─ index.html                 前端主页面
├─ server.py                  本地代理服务
├─ start.bat                  源码运行入口
├─ package_build.py           整合包构建脚本
├─ auto_package.bat           一键打包脚本
├─ auto_publish_gitee.bat     一键打包并推送 Gitee 脚本
├─ .gitignore                 Git 忽略规则
└─ release_build/             最终整合包输出目录
```



#### 常见问题

1. 页面打不开  
   请确认本地服务是否已经启动，并访问：
   `http://localhost:8765`

2. 提示跨域错误  
   请不要直接双击 `index.html` 打开，必须通过 `server.py` 或 `start.bat` 启动本地代理服务。

3. 视频任务成功但不显示  
   可能是接口返回了完成状态，但没有返回可播放地址。当前项目已经兼容多种字段，例如：
   - `video_url`
   - `output_url`
   - `download_url`
   - `remixed_from_video_id`

4. 整合包无法启动  
   请确认整合包目录中的 `AgnesAIStudioServer.exe`、`index.html` 和 `start.bat` 没有被删除。


#### 发行版说明



```text
Agnes AI Studio 最新整合包发布。

更新内容：
- 修复视频任务完成后不显示的问题
- 兼容 remixed_from_video_id 视频地址字段
- 优化视频任务轮询与超时提示
- 集成本地运行环境，开箱即用
```