LUMEN STUDIO

曜图工坊 · 让想象显影

一个电影级质感的 AI 图像工作台 —— 暗房美学、零构建、开箱即用。

English · 简体中文

为什么是 LUMEN STUDIO？

市面上的 AI 生图前端，要么是千篇一律的白底模板，要么是依赖成山的重型工程。LUMEN STUDIO 反其道而行 —— 把「胶片暗房」的仪式感带进浏览器，同时保持极简架构。

• 🎨 暗房美学 —— 深棕黑 × 琥珀金设计语言：巨型渐变排版、旋转光圈、光泽扫过、胶片颗粒，每一帧都像在显影液中浮现
• 🚀 零构建 —— 纯 Flask + 原生 HTML/CSS/JS，没有 Node、没有打包器，python app.py 即启动
• 🌍 三语实时切换 —— 中文 / English / Русский 一键切换，含西里尔字体自托管，离线可用
• 🖼 文生图 + 参考图改图 —— 无参考图走 images/generations，上传参考图自动切换 images/edits（远程 URL 走 JSON、本地文件走 multipart）
• ⚙️ 全参数控制 —— 1K/2K/4K 三档分辨率、五种画幅、批量张数、画质、背景、输出格式
• 🔒 密钥不出浏览器 —— API 密钥仅存于 localStorage，由本机 Flask 转发，仓库不含任何密钥
• 🗂 本地创作档案 —— 每个创作独立存档（JSON + 图片目录），侧边栏封面缩略图，随时回溯

快速开始

git clone https://github.com/xiaoyaya191/lumen-studio.git
cd lumen-studio
pip install -r requirements.txt
python app.py

打开 http://localhost:5000 ，点击右上角模型徽章完成配置：

配置项	说明
模型名称	如 gpt-image-2（需为 gpt-image-* 系列）
接口地址	任何 OpenAI 兼容端点，如 https://api.example.com/v1（自动补全 /v1）
API 密钥	你的 sk-... 密钥，仅保存在本地浏览器

保存后，输入提示词回车 —— 开始显影。

使用

• 生成 —— 输入提示词 → 回车或点击「生成」；灵感卡片可直接填充提示词
• 改图 —— 点击输入框左侧回形针上传参考图（支持多张），用提示词描述修改意图
• 预览 / 下载 —— 点击图片打开灯箱大图，右上角直接下载
• 参数 —— 输入框右侧齿轮展开参数面板

API 兼容性

后端按 OpenAI Images API 规范转发请求，任何兼容端点均可使用：

场景	端点	请求格式
文生图	POST /v1/images/generations	JSON
改图（URL 参考）	POST /v1/images/edits	JSON images[].image_url
改图（本地文件）	POST /v1/images/edits	multipart image 字段

支持参数：model prompt n size quality background output_format response_format

项目结构

├── app.py              # Flask 后端：API 转发、图片落盘、创作记录
├── index.html          # 单文件前端（HTML + CSS + JS）
├── fonts/              # 自托管变量字体（OFL 授权，离线可用）
├── docs/               # 文档与截图
├── images/             # 生成图片（自动创建，已 gitignore）
├── conversations/      # 创作记录（自动创建，已 gitignore）
└── requirements.txt

隐私

• API 密钥仅存于浏览器 localStorage，本仓库永不含任何密钥
• 生成记录与图片只落在本机目录，均不入库
• 无埋点、无统计、无第三方 CDN —— 字体全部自托管

许可证

MIT · 字体遵循 SIL OFL 1.1

把提示词交给暗房，让想象显影。

⭐ 如果 LUMEN STUDIO 帮到了你，欢迎 Star