Grok2API (二开版)

Note

本项目基于 chenyme/grok2api 二次开发，在原项目基础上新增了管理后台的多项增强功能。

原项目仅供学习与研究，使用者必须在遵循 Grok 的 使用条款 以及 法律法规 的情况下使用，不得用于非法用途。

基于 FastAPI 重构的 Grok2API，全面适配最新 Web 调用格式，支持流/非流式对话、图像生成/编辑、视频生成、深度思考，号池并发与自动负载均衡一体化。

二开新增功能

Imagine 图片生成/编辑

在管理后台"功能玩法"菜单下的 Imagine 页面（/admin/imagine）新增 图片编辑 模式。

模式	说明
生成模式	通过提示词从零生成图片（原有功能）
编辑模式	上传参考图片 + 提示词，基于图片进行 AI 编辑

编辑模式特性：

• 生成/编辑模式一键切换
• 支持拖拽或点击上传参考图片（最大 50MB）
• 图片预览与移除
• 调用 /v1/images/edits 接口，模型 grok-imagine-1.0-edit

---

Video 视频生成页面

在管理后台"功能玩法"菜单下的 Video 视频生成 页面（/admin/video），提供可视化的视频生成操作界面。

双模式支持：

模式	说明
单视频模式	单次生成一个视频，适合精细调参和预览
瀑布流模式	批量连续生成，支持并发控制（1-3 路），自动滚动、自动下载

功能特性：

• 提示词输入，支持 Ctrl+Enter 快捷生成
• 图生视频：上传参考图片，基于图片内容生成视频（单视频模式 & 瀑布流模式均支持）
• 可调节参数面板：
  • 宽高比：16:9 / 9:16 / 1:1 / 2:3 / 3:2
  • 视频时长：6s / 10s / 15s
  • 分辨率：480p / 720p
  • 风格预设：Custom / Normal / Fun / Spicy
• 流式/非流式输出切换
• 实时生成状态与参数同步显示
• 视频播放器预览（支持 URL 和 HTML 两种返回格式）
• 生成历史记录（本地持久化，支持点击回放和单条删除）
• 瀑布流专属功能：
  • 并发数控制（1/2/3 路同时生成）
  • 自动滚动到最新视频
  • 自动下载已完成视频
  • 批量选择、下载、删除
  • Lightbox 大图预览（支持键盘左右切换）
  • 优雅停止：点击停止后等待进行中的视频完成，不会中断生成

---

Token 管理增强

• 新增 「刷新全部」 按钮：一键刷新所有 Token 状态，无需手动全选

---

缓存管理增强

• 新增 批量下载：勾选多个本地图片/视频文件后，点击底部工具栏「下载」按钮，服务端自动打包为 ZIP（ZIP_STORED 不压缩）一次性下载；仅选 1 个文件时直接下载，不打包
• 新增 单文件下载：每行文件操作列新增下载图标，一键下载单个文件
• 新增 视频/图片在线预览：浏览器打开文件链接可直接播放视频或显示图片，不再触发下载

部署方式

Docker Compose 部署

git clone https://github.com/WangXingFan/grok2api.git

cd grok2api

docker compose up -d

后续更新镜像：

docker compose pull && docker compose up -d

如需从源码构建：

docker compose up -d --build

Vercel 部署

请务必设置 DATA_DIR=/tmp/data，并关闭文件日志 LOG_FILE_ENABLED=false。

持久化请使用 MySQL / Redis / PostgreSQL，在 Vercel 环境变量中设置：SERVER_STORAGE_TYPE（mysql/redis/pgsql）与 SERVER_STORAGE_URL。

Render 部署

Render 免费实例 15 分钟无访问会休眠，恢复/重启/重新部署会丢失。

持久化请使用 MySQL / Redis / PostgreSQL，在 Render 环境变量中设置：SERVER_STORAGE_TYPE（mysql/redis/pgsql）与 SERVER_STORAGE_URL。

环境变量

可在 docker-compose.yml 的 environment 中配置：

变量名	说明	默认值	示例
LOG_LEVEL	日志级别	INFO	DEBUG
LOG_FILE_ENABLED	是否启用文件日志	true	false
DATA_DIR	数据目录（配置/Token/锁）	./data	/data
SERVER_HOST	服务监听地址	0.0.0.0	0.0.0.0
SERVER_PORT	服务端口	8000	8000
SERVER_WORKERS	Uvicorn worker 数量	1	2
SERVER_STORAGE_TYPE	存储类型（local/redis/mysql/pgsql）	local	pgsql
SERVER_STORAGE_URL	存储连接串（local 时可为空）	""	postgresql+asyncpg://user:password@host:5432/db
SITE_MODE	站点模式（private/public）	private	public

MySQL 示例：mysql+aiomysql://user:password@host:3306/db（若填 mysql:// 会自动转为 mysql+aiomysql://）

管理面板

访问地址：http://<host>:8000/admin 登录密码来自配置项 app.app_key（必填，必须自定义强密码）。 若仍使用旧默认值 grok2api，服务会拒绝登录（可通过临时环境变量 ALLOW_INSECURE_DEFAULT_APP_KEY=true 兼容旧行为）。

功能说明：

• Token 管理：导入/添加/删除 Token，查看状态和配额
• 状态筛选：按状态（正常/限流/失效）或 NSFW 状态筛选
• 批量操作：批量刷新、导出、删除、开启 NSFW
• 配置管理：在线修改系统配置
• 缓存管理：查看、清理和下载媒体缓存（支持批量下载图片/视频）
• Imagine 图片生成/编辑：WebSocket/SSE 实时图片生成 + 图片编辑模式（二开增强）
• Video 视频生成：可视化视频生成，支持图生视频（二开新增）
• Voice Live 陪聊：LiveKit 语音会话

公开站 / 私有站模式

通过 SITE_MODE 环境变量控制部署模式：

模式	功能玩法页面	管理后台	API 接口
private（默认）	需要登录	需要登录	需要 API Key
public	无需登录，直接访问	仍需登录	无需 API Key

• private（默认）：所有页面和 API 均需认证，行为与之前完全一致
• public：功能玩法页面（/imagine、/video、/voice）无需登录即可使用，管理后台（/admin）仍需登录认证

# docker-compose.yml
environment:
  SITE_MODE: public  # 设为 public 开启公开站模式

致谢

• 原项目：chenyme/grok2api - 感谢 @chenyme 的出色工作