StarAI 是一套开源 AI 聚合平台，可把对话、推理、图片、视频、音频、智能体工作流和 OpenAI 兼容 API 聚合到同一个站点中。你可以用它搭建 AI 工具站、AI 创作平台、模型聚合平台或企业内部 AI 助手。
当前版本 0.6.0（2026-10-04）。完整更新记录 · New API 多媒体配置指南。后台「系统配置」点击「当前版本」可查看相同更新记录。
- 多模型聚合：统一接入对话、推理、图片、视频、音频等模型能力。
- 前台工作台：支持模型选择、参数配置、素材上传、任务生成和作品管理。
- 智能体工作流：支持多步骤分析、确认、生成和自动化创作流程。
- 灵感广场：支持作品展示、案例浏览、提示词复用。
- 用户体系：登录注册、钱包余额、卡密充值、扣费流水。
- 管理后台：模型、渠道、用户、任务、作品、公告、角色模板、系统配置。
- 开放 API：提供 OpenAI 兼容接口，便于下游系统调用。
- 多媒体接口模板：提供 20 个 New API / OpenLux 兼容、原生或透传模板，按实际模型能力覆盖 Grok、Doubao、Qwen、Wan、Vidu、MiniMax，支持自定义字段与异步结果映射。
- 独立售价与线路成本：支持按次、按秒、按 Token、按图计费，包含冻结、实际用量结算、失败释放和任务价格快照。
- Seedance 素材与视频协议：支持经认证的真人素材引用，TopEn JSON 与旧 Dola 30 秒 multipart 并存。
本次提供 7 个图片、9 个视频、4 个音频接口模板，增加 Vidu 异步参考生图 / 音效、Wan 文生 / 首帧图生视频、MiniMax Image-01 / Hailuo 与文件检索等兼容配置。各系列的可用模态、模型别名和参数以实际网关为准；Qwen / MiniMax 原生语音及复杂图片参数可继续使用已有官方模板。
加载优化包括首屏配置读取、仪表盘聚合查询和非默认语言词典按需加载；上传增加解析前请求体上限与临时文件清理。Docker 构建上下文排除本地工具、缓存、构建产物、上传备份及文档；本地审计报告不纳入版本控制，部署和配置指南继续保留。完整功能与兼容修复见更新记录。
- 在后台「模型管理」选择图片、视频或音频分类，再选择与网关协议匹配的接口模板。20 个兼容模板初始售价为 0，不会自动创建或启用业务模型。
- 填写实际 Base URL、API Key、鉴权类型与模型别名；生成路径、轮询路径及文件检索路径应对应同一协议。通用视频 JSON 与
/v1/videosmultipart 分别配置，Vidu 官方直连使用Token鉴权，网关按其文档设置。 - 二开接口可配置
runtime_rule.upstream的字段白名单、请求映射、状态 / 产物 / 用量映射及异步检索。不要仅替换模型名称而保留其他协议的字段；参考图、数量、时长与必填参数需与该型号的能力一致。 - 分别设置平台
price_rule和线路成本。按次售价是一份平台任务，按图按实际成功保存的图片数结算；按秒和按 Token 优先采用可信实际用量。用量缺失且无法测量时仍按估价结算，并记录用量来源。 - 更新 API、Worker、Admin 和 Web，准备可访问的媒体存储及 Worker 的 ffmpeg / ffprobe。用获授权账号检查提交、查询、结果下载、失败退款和实际用量后，再启用相应模型。
详细字段、计费精度、配置示例及网关限制见 New API 多媒体兼容与计费配置。实际供应商的权限、型号、售价与生成质量需单独验收；本地模拟回归不会自动确认这些商业配置。
| 模块 | 技术 |
|---|---|
| 前台 / 后台 | Next.js, React, TypeScript, Tailwind CSS |
| API | Go, Gin |
| 数据库 | PostgreSQL |
| 队列 | Redis, Asynq |
| 部署 | Docker Compose |
本地开发建议：
| 环境 | 要求 |
|---|---|
| Node.js | 20+ |
| pnpm | 建议使用 Corepack |
| Go | 1.25+ |
| Docker | Docker Desktop 或 Docker Engine |
| Git | 用于拉取代码 |
Windows 用户建议使用 PowerShell，并提前启动 Docker Desktop。
项目提供两份可提交模板：
| 文件 | 用途 |
|---|---|
.env.local |
本地一键开发模板，使用 localhost、本地 PostgreSQL/Redis/MinIO/Mock 网关 |
.env.example |
生产一键部署模板，使用 Docker Compose 内部主机名 postgres、redis 和单域名部署占位 |
本地开发：
cp .env.local .env生产部署：
cp .env.example .env.production生产环境必须修改 .env.production 里的域名、对象存储和模型网关配置。数据库密码和 JWT 密钥可以先使用模板默认值完成快速部署，但正式公开使用前建议改成随机强密码。
Windows / PowerShell：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\dev.ps1脚本会自动：
- 如果没有
.env，从.env.local创建。 - 启动 PostgreSQL、Redis、MinIO。
- 执行数据库迁移。
- 安装前端依赖。
- 启动 API、Worker、Mock 模型网关、前台和后台。
启动后访问：
| 服务 | 地址 |
|---|---|
| 前台 | http://localhost:3000 |
| 后台 | http://localhost:3001 |
| API | http://localhost:8080 |
| Mock 模型网关 | http://localhost:3002 |
| MinIO 控制台 | http://localhost:9001 |
默认开发账号：
| 类型 | 账号 |
|---|---|
| 管理员 | admin@starai.local / admin123 |
| 测试用户 | demo@starai.local / demo123 |
| 测试卡密 | STARAI-DEMO-1000 |
生产环境上线后必须修改默认账号密码和所有密钥。
cp .env.local .env
pnpm install
make docker-up
make migrate-up分别启动服务：
make dev-mock
make dev-api
make dev-worker
pnpm dev:web
pnpm dev:admin单域名宝塔部署推荐：
cp .env.example .env.production
# edit .env.production
bash scripts/deploy-prod.sh部署脚本会校验生产环境变量。如果 APP_ENV=production 但仍使用 localhost 或 yourdomain.com，脚本会停止，避免构建出错误的前端包。数据库密码和 JWT 密钥使用模板默认值时只会提示警告，不会阻断部署。
常用更新命令：
# 更新全部服务
bash scripts/deploy-prod.sh
# 只更新前台和后台
BUILD_SERVICES="web admin" bash scripts/deploy-prod.sh
# 只更新 API 和 Worker
BUILD_SERVICES="api worker" bash scripts/deploy-prod.sh
# 前端地址或代码异常时，无缓存重建
NO_CACHE_SERVICES="web admin" BUILD_SERVICES="web admin" bash scripts/deploy-prod.shSearXNG 默认不启动。需要自建搜索时，在 .env.production 设置：
SEARXNG_ENABLED=true
# 先运行 openssl rand -hex 32，再把输出粘贴到下面
SEARXNG_SECRET=粘贴生成的随机值重新运行部署脚本后，在管理后台“系统配置 → Agent 联网搜索”选择 SearXNG，服务地址填写 http://searxng:8080。服务仅在 Docker 内网开放，默认限制为 1 CPU、768 MB 内存；搜索结果继续使用 StarAI Redis 缓存。
本地开发可在 .env.local 设置 SEARXNG_ENABLED=true，重启 scripts/dev.ps1 后使用 http://127.0.0.1:8888。
详细部署教程：
# 前端构建
pnpm build:web
pnpm build:admin
# API 测试
cd services/api && go test ./...
# Worker 测试
cd services/worker && go test ./cmd/worker
# Docker 磁盘报告
bash scripts/docker-disk-maintenance.sh report
# Docker 安全清理
bash scripts/docker-disk-maintenance.sh safe-cleanapps/
web/ 用户前台
admin/ 管理后台
services/
api/ Go API 服务
worker/ 异步任务 Worker
mock-new-api/ 本地 Mock 模型网关
infra/
docker/ Docker Compose 配置
migrations/ 数据库迁移
scripts/ 开发、部署、备份、维护脚本
docs/ 部署和运维文档
- 不要提交
.env、.env.production、数据库备份、配置包、真实 API Key、OAuth Secret、邮箱密钥。 - 公开仓库前建议执行数据脱敏脚本，清理真实域名、邮箱、模型密钥、任务记录和用户业务数据。
- 模型供应商 API Key 只能保存在后端环境变量或后台安全配置中，不要写进前端代码。
- 管理后台上线后必须使用强密码，建议限制访问 IP 或增加网关鉴权。公开生产环境建议修改默认数据库密码、
JWT_SECRET和ADMIN_JWT_SECRET。 - 正式开放注册前，请自行处理内容安全、频率限制、滥用防护和数据备份。
- 启用在线支付前，请先完成支付合规、回调验签、订单对账和退款异常处理。
本项目采用 MIT License 开源。
使用本项目对接第三方 AI 模型、支付、邮箱、对象存储等服务时，请自行遵守对应服务商协议和当地法律法规。MIT License 不提供任何明示或暗示担保，生产环境使用前请自行完成安全、合规和风控审查。