一、人工智能（AI大模型）

SparkAi系统是一款支持多语言国际化的{ 渐进式 }AIGC系统，基于OpenAI/ChatGPT、最新旗舰大模型GPT-6、Anthropic Claude（Claude-Opus-5-5 / Claude-Fable-5-1）、Google Gemini、DeepSeek、GPT-Image-2 / GPT-Image-2.5绘画、Nano-Banana-2第二代绘画、Midjourney V8、VEO3.1 / Sora-2视频、Seedance2.5视频、Agent智能体 扣子（Coze）插件、工作流、函数、知识库 等AI大模型能力开发的一站式AI系统；支持「AI聊天」、「专业AI绘画」、「AI智能体」、「Coze-Agent工作流应用」、「AI视频生成」等，支持独立私有部署！提供面向个人用户 (ToC)、开发者 (ToD)、企业 (ToB)的全面解决方案。

新版本蓄力中（V7.0大版本，我们不仅在AI视频模块进行重构和新增，同时将对大模型对话、智能体（预设应用/GPTs应用）进行重大更新）！

部分更新内容预览：

二、系统快速体验

• 系统用户端：https://test.sparkaigc.com

• 管理后端：https://test.sparkaigc.com/sparkai/admin

• 测试账号密码：admin 123456

三、系统功能模块

🤖 一、AI 大模型对话

对话能力与模型支持

1. 🔥全模型支持：支持 OpenAI 官方 API + 一切标准 chat 格式中转 API；覆盖 OpenAI（GPT-6 / GPT-5.4 / GPT-5.4-pro / o3 / o4-mini / Codex 系列）、Anthropic Claude（Claude-Opus-5-5 / Claude-Fable-5-1 等）、Google Gemini（Gemini-3.1-pro 等）、DeepSeek（deepseek-r1 等）、Azure OpenAI，以及豆包、通义千问、智谱 ChatGLM、Moonshot、讯飞星火、百川、腾讯混元、360 智脑等国内模型；适配 LocalAI / Ollama 本地模型

2. 🎈后台自由自定义接入最新大模型（无需系统更新）：OpenAI 全模型、Claude 全模型、Gemini 全模型、国内 AI 全模型及三方主流大模型统一走标准 chat（OpenAI）格式，新模型发布后即可在后台自由新增对接并立即使用；支持模型自定义分类、名称、排序、Logo 与厂商分组

3. 🧭双端点智能路由【V6.9.6】：按模型能力自动路由 Chat Completions / Responses 端点——命中规则的 OpenAI 官方系列（GPT / o 系列 / Codex）走 Responses 官方通道，Claude / Gemini / DeepSeek 等稳定使用 Chat Completions；内置多级失败自动降级重试

4. ⚙️大模型全局配置中心【V6.9.6】：统一管理端点路由规则、失败是否扣费、stream 流式参数等全局策略，支持正则规则与模型名实时测试，保存即时生效、无需重启

5. 📄多类型文档理解【V6.9.6】：官方模型支持 PDF / Word / PPT / Excel / 文本 / Markdown / HTML 等文件上传识别（非 PDF 文件建议选择 GPT 系列模型，经 Responses 端点）；支持 URL 拼接 / Base64 内联 / 文件链接三种提交方式，按体积与 Token 上限自动择优与降级

6. 👀对话文件在线预览【V6.9.6】：PDF / Word / PPT / Excel / 文本 / Markdown / HTML 在线查看、打印、下载，Coze Agent 对话同步支持

7. 🖼️多模态图像理解：单图 / 多图上传（最多 9 张），支持手机原生相机与 PC 摄像头拍照上传【V6.9.3】；用户消息多图自适应排版【V6.9.6】；API 返回图片自动预览

8. 🤔深度思考与推理：支持 o3 / o4-mini、DeepSeek-R1 等推理模型，思维链（ReasoningContent / Think 标签）流式输出与展示，支持深度搜索过程显示

9. 🛜联网搜索：支持模型联网扩展搜索实时内容并总结（如 o4-mini-all：联网 + 推理 + 图像 + PDF 文档分析）

10. 🛡️高可靠对话内核【V6.9.3】：上游（后端 ↔ 大模型）与下游（前端 ↔ 后端）连接解耦，切换会话、关闭页面、退出客户端均不中断生成；SSE 边生成边落库，切回会话可续显；「停止回答」即时取消上游请求；首字超时 / 空响应统一兜底；多会话并发隔离

11. 📌对话导航条【V6.9.5】：当前对话组内提问 ≥ 3 条时自动出现，支持折叠、悬停展开、点击定位

12. Ⓜ️强大的内容渲染：Markdown（代码高亮 / LaTeX / KaTeX 公式 / Mermaid / 图表绘制）、思维导图生成与 PDF 导出、代码文件下载、对话重新编辑

13. 🗣️语音对话：支持 OpenAI / Azure 语音识别与 TTS（Whisper & TTS 格式中转），语音输入语音回复、多种音色选择，后台可开关语音播放

14. 🏄♂️插件系统与开放对接：内置插件系统（识图、文档分析等，持续扩展）；兼容 chat 接口的知识库或工作流应用（如 FastGPT 知识库 / 工作流）可作为模型接入，或绑定到智能体使用

🎨 二、专业 AI 绘画

独立绘画模块与模型支持

1. 🖌️GPT-Image-2 独立绘画模块【V6.9.2】【V6.9.3】：支持 gpt-image-2、gpt-image-2.5、GPT-Image-2-Dev 等模型，后台可自定义接入 API 与扩展模型版本；文生图、参考图绘画（最多 8 张智能参考图）、已生成结果在线编辑与涂抹框选编辑；画质（low / medium / high / auto）、数量、比例与自定义分辨率严格按官方参数范围提交；支持单用户 / 全系统并发限制

2. 🍌Nano Banana 2 独立绘画模块【V6.9.4】：支持 gemini-3.1-flash-image、gemini-3-pro-image，可自定义扩展模型版本（如 gemini-3.1-flash-lite-image）；文生图、多张智能参考图编辑、自定义分辨率与比例（2K / 4K 输出取决于模型）；也可在 AI 对话中直接选用 Nano Banana 模型绘图

3. 🎨Midjourney / Niji 全功能：支持 MJ V7 / V8（V8 待官方 API 正式开放后直接可用）；Imagine / Upscale / Vary / Zoom Out / Pan、Vary Region 局部重绘、图像混合，普通参考图 / 角色一致（cref）/ 风格一致（sref）参考图组合使用；Fast / Relax 双通道独立计费与并发；绘画进度实时渲染

4. 🪄DALL·E 2 / 3 绘画：支持全部参数

5. 🔁通用绘画能力：「画同款」一键复用参数；各模型、各操作积分价格前端动态显示；绘画失败自动退还积分（幂等退款，杜绝重复返还）【V6.9.6】；异常任务定时补偿；原图 + 缩略图私有化存储；各绘画模型前端显示开关；绘画进度条

6. 🖼️AI 画廊广场：「画廊精选 / 我的绘画」分栏加载【V6.9.5】；作品风格分类、轮播图、创作者中心；视频作品悬停自动预览播放

7. 🚥绘画内容风控【V6.9.3】：GPT-Image / Midjourney / Niji / DALL·E 提示词提交前即做敏感词拦截，不调用上游、不扣费，违规记录同步至管理后台

🎬 三、AI 视频生成

视频模型支持

1. 📽️VEO3 / VEO3.1 视频：支持 VEO3.1、VEO3.1-fast、VEO3.1-pro 等模型，生成视频自动配套音频（标准 chat 对话形式调用）

2. 📽️Sora-2 视频：支持 Sora-2 视频生成（标准 chat 对话形式调用）

3. 🎞️Midjourney HD 视频【V6.8.6】：已生成图片一键生成「动图（高运动 / 低运动）」，支持自定义动作描述、单次 1 / 2 / 4 条生成，独立扣费配置

4. 🎬独立 AI 视频模块：文生视频 / 图生视频（Pika），视频作品广场展示

5. 🌱Seedance 视频（Coze-Agent）：通过 Coze-Agent「Seedance 大模型视频生成」应用调用字节跳动官方 Seedance 模型，支持首尾帧与带声音视频，生成结果在系统内直接预览播放

6. 🔜即将上线：Seedance2.5 视频、Qwen-Image 图片编辑、可灵等独立图片 / 视频模块（2026 下半年开发计划）

🧠 四、AI 智能体（Agent）

智能体与应用生态

1. 🤖Coze Agent 智能体模块：支持扣子（Coze）插件、工作流、函数、知识库智能体对接；实时流式响应，展示思考过程与模型 / 插件 / 工作流调用详情；单智能体多开对话；支持多文件类型上传，图片 / 视频结果直接预览

2. 📥智能体批量管理：从 Coze 平台一键批量导入与同步智能体（Redis 分布式锁防重复），图标自动私有化存储

3. 📈智能体商店：自研评分、活跃度、热度算法；推荐问题、关键字搜索；链接分享、微信扫码分享、海报分享

4. 🧠GPTs 与预设应用：GPTs 应用全网搜索一键接入；Prompt 自定义预设应用；用户自建智能体；应用可绑定模型、分享链接、共享到广场

💰 五、会员积分与商业运营

计费、支付与增长

1. 🧑🤝🧑会员积分体系：普通模型积分、高级模型积分、绘画积分、Agent 积分多种余额；按次 / 按时间 / 组合套餐等多种计费方式，每个模型可自定义扣费

2. 🧾积分明细系统【V6.9.6】：用户端与管理端口径统一，完整记录全模型使用的消耗、失败返还、失败免扣，时间精确到秒，支持多维度筛选对账；管理后台对话列表展示每条回复的积分消耗

3. 🆓模型调用失败零扣费【V6.9.6】：4xx / 5xx、超时、空回复可按开关不扣积分；失败 / 中断 / 空回复统一结算出口，杜绝误扣与重复扣费，并具备防刷保护

4. 🛍️支付系统：微信官方支付（PC 端 Native 扫码、手机微信内 JSAPI）、易支付、码支付、虎皮椒支付；订单状态同步检查、订单搜索与管理

5. 🛒商城与增长工具：永久 / 限时套餐商城、签到奖励、邀请奖励、卡密兑换（批量生成与管理）、访客体验模式

6. ⏏️分销系统：A + B 分销模式，可按用户单独设置提成；支持提现门槛与支付宝 / 微信 / 银行卡提现

7. ✨渠道负载均衡：自研渠道均衡负载与分配算法，API Key 池多 Key 轮询（优先级 / 权重 / 状态管理），支持批量添加与删除

🔐 六、安全与风控

内容安全与账户安全

1. 🚥内容风控：自定义敏感词 + 百度内容审核，覆盖对话、绘画、思维导图，命中即前置拦截；违规检测记录与用户快照全量留痕

2. 📍登录设备与异地识别【V6.9.6】：记录登录 IP（解析至运营商与所在城市）、浏览器、操作系统与设备类型；用户可在个人中心查看最近 5 次登录设备与在线状态，管理端同步展示

3. 🔑会话安全：普通用户仅允许单设备在线；超级管理员账户按登录 IP 区分会话，异地登录相互强制下线并记录 IP；支持后台强制指定用户下线【V6.9.4】、封禁用户

4. 🙈敏感信息脱敏：演示 / 非超管账户查看 IP 与地区、配置值、API 地址、密钥、用户名、邮箱等信息时统一脱敏；admin 演示账户只读

5. 📤上传安全：服务端拒绝脚本 / 代码类可执行文件；开启云存储后禁止匿名写入本机磁盘，游客上传限频限量

6. 🧪「系统功能测试」开关【V6.9.4】：开启后所有 AI 生成请求在系统层统一阻断、不调用上游 API，适用于尚未完成生成式人工智能备案的上线阶段

7. 📧注册防护：邮箱域名白名单、可禁用「+」别名邮箱、临时邮箱过滤；注册赠送额度防篡改

🛠️ 七、管理后台与站点运营

后台管理与运营配置

1. 📊数据仪表盘：用户、对话、绘画、订单统计与近 7 日趋势折线图，模型使用次数与 Token 使用饼图

2. 💻完整管理后台：用户、订单、对话、绘画、视频等数据管理，支持 Excel 导出；百万级数据量查询优化（统计查询并发 + Redis 缓存）；用户列表展示登录 IP 记录【V6.9.6】

3. 🗂️模型与卡池管理：模型分类、排序、Logo、厂商分组，按厂商预选新一代模型【V6.9.6】；API 卡池批量添加 / 删除 Key

4. 🎭对话演示数据【V6.9.5】：可指定任意对话组（最多 5 条）作为全站只读演示内容

5. ✔️站点自定义：Logo / 站点名称 / 页脚 / 百度统计 / 版权信息 / 备案号 / 公告 / 欢迎语 / 关于我们 / 用户协议等均可后台配置；网站直播入口【V6.9.2】

6. 🧩动态菜单与轮播图：支持内嵌网页、外链、内部路径跳转，自定义图标，PC 与移动端分别配置；广告位 / 活动 / 教程轮播展示

7. ♻️微信公众号联动：公众号登录、关键词自动回复

8. 🔐权限系统：超级管理员与演示账户分级权限

🌏 八、多端体验与系统架构

体验、性能与部署

1. 🌐系统全国际化【V6.9.1】：前端界面 + 后端配置信息 + 后端返回信息全量国际化，按访问 IP 与浏览器语言自动切换；管理后台配置内容一键 AI 翻译，支持出海运营

2. 🎨双风格 UI【V6.9.0】：卡片风格 / Notion 风格用户自由切换；AI 对话沉浸模式、「添加菜单」收纳、液态玻璃按钮、明暗主题自动适配

3. 📲多端支持：PC 端 + 手机 H5 + 微信公众号，自适应 PC / 移动端 / 平板；支持 PWA，H5 可打包至其他平台

4. ⚡性能优化【V6.9.5】：中文字体子集化（单个字重 4.2MB → 0.9MB），单页资源下载量降低约 50%，移动端资源分批加载，降低 iOS 等低内存设备崩溃风险

5. 🚀高并发服务端：Node.js + NestJS 服务端，Redis 缓存与 MySQL 连接池自适应，适配高并发业务场景

6. 🗄️存储与数据同步：本地存储 / 阿里云 OSS / 腾讯云 COS / Chevereto 图床，用户文件与绘画数据私有化存储；对话会话隔离、云端存储，多设备数据同步

7. 🖥️部署运行：支持宝塔常规部署与 Docker 一键部署，所有对接配置均在后台界面完成；适用于商业运营、企业内部、教育培训等多种场景

8. 🏅持续更新：已坚持开发迭代三年半，保持稳定的大版本更新节奏，更多 AI 能力持续开发中……

四、部署教程（Node.js + PM2 部署）

这里使用标准Node.js + PM2 部署项目，系统提供Docker快速部署教程

当你进入这个栏目的时候说明你已经想要使用宝塔面板部署了、如果你不知道什么是宝塔、那么请前往宝塔官网进行简单的了解、我们默认你已经安装了宝塔面板、这是最基础的需要。

第一步 4.1 环境安装

宝塔需要安装的环境

• Nginx >= 1.19.8

• MySQL >=5.7或者MySQL 8.0

• PHP-7.4（非系统需要环境）

• PM2管理器 5.5

• Redis 7.0.11

• Node版本：>=v16.14.1

初始安装环境推荐使用LNMP一键环境套件

如果您的服务器CPU核心函数、内存配置较高，可直接安装mysql8版本

注意： 使用mysql8.0版本，部分宝塔版本 需要重置root密码才能创建数据库

​​​​​​​

第二步 4.2 Node版本选择

使用PM2切换Node版本（必须）

• 切换Node版本为：大于等于v16.14.1（这里为v16.19.1）

​​​​

第三步 4.3 安装pnpm模块

（宝塔默认会安装pnpm 9 的最新版本，此版本要求Node.js版本最低为18，很多linux版本不支持最新pnpm 9）

​​​​​​

先设置npm为官方源：

npm config set registry https://registry.npmjs.org/

单独安装pnpm：

请直接安装pnpm 8 的版本

npm install -g pnpm@8

​​​​

此时再次打开终端、确定我们需要是否有node相关环境

分别执行以下命令，出现版本号说明已经安装成功

node -v npm -v pnpm -v

​​​​

验证pm2环境是否存在：

pm2 -v

如果提示pm2: command not found，则并没有成功安装，再次手动命令安装：

npm install -g pm2

再次输入pm2 -v显示以下页面，则成功安装

​​​

第四步 4.4 安装Redis

​​​​

第五步 4.5 部署跑起来

4.5.1 新建站点

宝塔 -> 网站 -> 添加站点

​​​​

4.5.2 配置SSL证书

如果自己没用商业SSL证书，就使用宝塔免费证书，申请Let's Encrypt证书

​​​​

开启强制HTTPS并保存

​​​​

4.5.3 上传SparkAi系统源码

进入网站站点根目录

​​​​

删除新建站点生成默认文件

​​​​

将系统程序上传并解压到网站根目录下​

解压源码包

​​​​

4.5.4 配置.env文件

复制一份.env.example文件，并重命名为.env文件

​​​​

修改.env配置文件为自己站点信息​

• 其中mysql为必配项目、redis服务必须安装 否则无法启动项目
• jwt token 必须修改为自己个人的密钥（再原有基础上再加一点随机英文即可）

4.5.5 启动项目

4.5.5.1 开启端口

宝塔面板安全开启9520端口（如果在配置文件自定义了其他端口，开启对应端口即可，不要和系统一些端口冲突，建议默认9520端口）

​​​​

4.5.5.2 安装依赖

直接在网站根目录打开ssh终端

​​​​

如果打开不在网站根目录请切换为网站根目录

cd /www/wwwroot/你的网站目录

宝塔默认为淘宝旧源，请切换淘宝最新源：

npm config set registry https://registry.npmmirror.com

使用pnpm i命令 回车 安装依赖

​​​​

使用pnpm start命令启动项目

pnpm start

​​​​

4.5.5.3 查看启动日志

输入pm2 log查看详细日志、看到下图表示成功！

pm2 log

​​​​

初始化创建super用户成功、用户名为[super]、初始密码为[sparkai]

4.5.6 添加反向代理

添加站点9520端口，宝塔安全需要开启该端口，不然无法访问

目标url:http://127.0.0.1:9520

​​​​

4.5.7 搭建完成

搭建完成，访问域名，输入域名授权码即可

第六步 5.6 授权激活系统

访问你自己的系统前台域名

5.6.1 未授权激活

​​​​

5.6.2 激活成功示例